> For the complete documentation index, see [llms.txt](https://docs.themeupstudio.com/travio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themeupstudio.com/travio/rename-taxonomies/rename-visible-text.md).

# Rename Visible Text

## Rename Visible Text

Start here if you want visitors to see a different name, such as **Places** instead of **Destinations**.

{% hint style="warning" %}
This step changes text only. It does not change URLs.
{% endhint %}

### File to edit

```txt
locales/en.json
```

This file contains text labels used by the theme.

Each line has two parts:

```json
"Original theme text": "Text shown on your site"
```

Only edit the text on the right side.

{% hint style="danger" %}
Do not change the text on the left side unless you are also editing the theme templates.
{% endhint %}

### Before you edit

Make a copy of `locales/en.json` first.

Keep the file as valid JSON:

* Keep the double quotes
* Keep commas between lines
* Do not add a comma after the final line in the file
* Use a plain text/code editor

### Example: Destinations -> Places

Find these lines:

```json
"Destinations": "Destinations",
"Destination icon": "Destination icon",
"Destinations ribbon": "Destinations ribbon",
"No more destinations": "No more destinations",
"Pick a destination": "Pick a destination",
"View all destinations": "View all destinations"
```

Change only the right side:

```json
"Destinations": "Places",
"Destination icon": "Places icon",
"Destinations ribbon": "Places ribbon",
"No more destinations": "No more places",
"Pick a destination": "Pick a place",
"View all destinations": "View all places"
```

### Example: Experiences -> Travel Styles

Find these lines:

```json
"Experiences": "Experiences",
"Experience icon": "Experience icon",
"Experiences ribbon": "Experiences ribbon",
"No more experiences": "No more experiences",
"Pick an experience": "Pick an experience",
"View all experiences": "View all experiences"
```

Change only the right side:

```json
"Experiences": "Travel Styles",
"Experience icon": "Travel Styles icon",
"Experiences ribbon": "Travel Styles ribbon",
"No more experiences": "No more travel styles",
"Pick an experience": "Pick a travel style",
"View all experiences": "View all travel styles"
```

### Combined ribbon text

If you use the homepage ribbon that shows both groups together, update these too:

```json
"Destinations and experiences": "Places and travel styles",
"Destinations and experiences ribbon": "Places and travel styles ribbon"
```

### Navigation warning text

Travio may show a warning if special navigation tokens are configured incorrectly.

You can leave this line unchanged:

```json
"Navigation configuration issue detected. Check [destinations]/[experiences] and related custom tag slug settings.": "Navigation configuration issue detected. Check [destinations]/[experiences] and related custom tag slug settings."
```

Or you can rewrite the right side so it mentions your new public names:

Example:

```json
"Navigation configuration issue detected. Check [destinations]/[experiences] and related custom tag slug settings.": "Navigation configuration issue detected. Check [destinations]/[experiences] tokens and the Places/Travel Styles tag slug settings."
```

Keep `[destinations]` and `[experiences]` inside the warning unless you have also changed the theme code that reads those tokens.

### Full text list to review

Review these entries when renaming the visible labels:

| Current key                           | Used for                                           |
| ------------------------------------- | -------------------------------------------------- |
| `Destination icon`                    | Header destination dropdown icon alt text          |
| `Destinations`                        | Headings, filters, header dropdown labels, ribbons |
| `Destinations and experiences`        | Combined homepage ribbon label                     |
| `Destinations and experiences ribbon` | Combined homepage ribbon aria label                |
| `Destinations ribbon`                 | Destination-only homepage ribbon aria label        |
| `Experience icon`                     | Header experience dropdown icon alt text           |
| `Experiences`                         | Headings, filters, header dropdown labels, ribbons |
| `Experiences ribbon`                  | Experience-only homepage ribbon aria label         |
| `No more destinations`                | Destinations index load-more button                |
| `No more experiences`                 | Experiences index load-more button                 |
| `Pick a destination`                  | Header destination dropdown placeholder            |
| `Pick an experience`                  | Header experience dropdown placeholder             |
| `View all destinations`               | Homepage section link                              |
| `View all experiences`                | Homepage section link                              |

You may also see text such as:

```json
"Unlock the full experience": "Unlock the full experience"
```

That is membership or marketing copy. It is not the Experiences taxonomy. Change it only if you want to change that sentence everywhere it appears.

### After editing

Zip and upload the theme again in Ghost Admin.

When you create the ZIP, make sure `package.json` is at the root of the ZIP file. Do not zip a parent folder that contains the theme folder inside it.

Then check:

* Homepage section headings
* Header dropdown labels
* Header dropdown placeholder text
* Homepage ribbon labels
* "View all" links
* Load-more button text on the renamed index pages

### If the text does not change

Check these common causes:

* The edited theme was not uploaded
* Browser or hosting cache still has the old files
* The JSON file has a formatting error
* You changed the left side instead of the right side
