> For the complete documentation index, see [llms.txt](https://help.smartrr.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartrr.com/docs/support/admin-portal/translations.md).

# Translations

Smartrr's Translations feature allows you to override the default copy in your shop's Customer Account Portal.

In your Smartrr admin, navigate to **Theming** > **Translations**. The changes made here will take effect on text in the account portal and `<%- variable %>` results in email notifications. The Translations menu has the following categories:

* **General** - general text found through the customer portal.
* **Header** - Heading for cards in the customer portal.
* **Tabs** - The "Subscriptions" and "Next Order" tabs on the subscription card.
* **Error Messages** - All error messages that are displayed in the customer portal.
* **Customer Actions** - The action items that are available to customers (i.e. skip, cancel, swap item, edit address, etc).
* **Subscriptions** - Text associated with subscription menus or actions.
* **Order History** - Controls the text in the order history card.
* **Select Modal** - Translation for the texts ("What would you like to manage?", "Only next order", "All upcoming orders").
* **Edit Bundle (BYOB)** - Text for bundle subscription content.
* **Settings** - For the settings card found close to the end of the customer portal page.
* **Loyalty** - Targets loyalty content in the customer portal.
* **Review** - Translation for the texts "Leave a Review" and "Share your thoughts".
* **Social** - Texts displayed on the "Social" card (this is where Instagram posts are shown when your Instagram account is connected).
* **Trending** - Targets text in the Trending card.
* **Quick Buy** - Text for the add-on items' card.
* **Dates** - Dates displayed in the customer portal and emails notifications.
* **Badge Status** - Badges that are displayed on the subscription card or in a banner in the customer portal.
* **Banner** - Banners that display important messages or warnings related to an item in an active subscription.
* **Address Form** - The address form that's displayed in an order's details or in the subscription card, and when the customer is editing/updating their address in the customer portal.
* **Delivery** - Targets shipping text.
* **Error Fallback** - Translation for the "Error updating subscription" text.
* **Utils** - Set your preferred date format. Also impacts email notifications.
* **Defaults** - Translations for days of the week and months.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FO2H8DzLfDk5abOJQ0wzh%2FScreenshot%202024-04-10%20at%2012.09.02%E2%80%AFPM.png?alt=media&amp;token=8942f48b-7c5c-4a77-a722-d37ed07a4260" alt="The translation dashboard in the admin portal."><figcaption></figcaption></figure>

The categories are found to right and are hyperlinked to their position on the page. Clicking on a category will jump you right to it.

To translate a field, simply toggle the "OFF/ON" toggle next to the field. When it's toggled on, the field is no longer disabled, and available for editing.

### Customer Account Portal Language

Use our 1-click translation feature to quickly change all copy in the Customer Account Portal to:&#x20;

* English&#x20;
* French&#x20;
* Spanish
* Portuguese

When selecting a new language, make sure to save and publish to your preferred theme:&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FmdkC9UA64PnZ30EoKQdy%2FScreenshot%202024-04-10%20at%2012.10.34%E2%80%AFPM.png?alt=media&amp;token=0000ee57-2145-4efc-be14-e4ac57555852" alt="Prompt shown to save changes to your preferred theme. Carefully choose the theme that you&#x27;re applying the translated changes to."><figcaption></figcaption></figure>

### Overrides

You can use overrides to change one-off instances of text in the customer account portal. For example, you might want to change "Next Order" in your Subscriptions section to say "Upcoming":

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FreHLWfMyLsNxGeeJkpjI%2FScreenshot%202022-11-01%20at%204.40.43%20PM.png?alt=media&amp;token=19b77c06-2353-4b1b-a184-a2a9479253c6" alt="Screenshot of the subscriptions card and the &#x22;Next order&#x22; tab highlighted. There&#x27;s a side by side comparison showing this text translated to &#x22;Upcoming&#x22;."><figcaption></figcaption></figure>

Use our Quick Jump tool to find the section you're looking for. Or, use **⌘F** to quickly search for the term you're looking for on the Translations page.&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fakf5NFWH9Y8yyMXsLcAP%2FScreenshot%202024-04-10%20at%2012.12.03%E2%80%AFPM.png?alt=media&amp;token=e6f53a44-3a76-4ec2-a278-5235e6b457eb" alt="Using the &#x22;Quick Jump&#x22; categories section to quickly navigate to the &#x22;Tabs&#x22; category."><figcaption></figcaption></figure>

Edit text in the **Override text** field by turning the toggle **ON**.&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2F137PD28BZsD6ZBsFddwS%2Fezgif.com-gif-maker%20(1).gif?alt=media&amp;token=0a710f1e-2d6b-48fb-8704-8c3cee955cac" alt="Gif displaying a field being edited/translated after toggling the field &#x22;On&#x22;."><figcaption></figcaption></figure>

Don't worry—your text is cached when you toggle the field OFF/ON:&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FnN1NerPiLQ4f8bVMVwu5%2Fezgif.com-gif-maker%20(2).gif?alt=media&amp;token=3c56bc4a-5155-4be7-b302-6f42423a8315" alt="Gif showing that the previous text is reverted when the field is toggled &#x22;Off&#x22;. This is helpful if you no longer wish to translate a field, and want to undo your change before saving."><figcaption></figcaption></figure>

Once you're done with your overrides, make sure to save and publish to your preferred theme:&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FMtPTi7s9Se3cx38NMViI%2Ftheme.png?alt=media&amp;token=5b6d2525-90af-4247-b98b-34fe2660def2" alt="Always remember to commit your changes by saving them and confirming the theme to apply the changes to."><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** There are some copy instances that include variables. These are indicated with a double asterisk (\*\*). We recommend not removing these variables from your overrides. However, if you do accidentally delete, you can always reference the original text in the **Original (translated) text** field.\
\
Example:&#x20;

<img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2F2ItuENz0y07JLPufqKoh%2FScreenshot%202022-11-01%20at%204.44.50%20PM.png?alt=media&amp;token=8577f5cd-cf1b-45a6-ba57-2324b0bbfd81" alt="Example showing the deliveryFrequency variable overridden with the toggle on." data-size="original">
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.smartrr.com/docs/support/admin-portal/translations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
