> For the complete documentation index, see [llms.txt](https://pinathemes.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pinathemes.gitbook.io/docs/breeze/advanced/translate.md).

# Translate

The theme includes built-in support for multiple languages and can be fully translated using simple JSON files. It also offers automatic RTL support for the Arabic language (AR).

Included Languages:

* English (EN)
* Spanish (ES)
* French (FR)
* Portuguese (PT)
* German (DE)
* Italian (IT)
* Arabic (AR)

### How it Works

Translations are managed through Ghost’s official `{{t}}` helper and JSON files stored in the theme’s `locales/` folder. You can edit existing translations or add new ones easily, without the need for any additional setup or dependencies.

For more information, see: [Ghost Translate System](https://ghost.org/docs/themes/helpers/translate/)

### How to Edit or Add a Translation

{% stepper %}
{% step %}
Unzip the theme on your computer.
{% endstep %}

{% step %}
Open the "**locales**" folder inside the theme directory.
{% endstep %}

{% step %}
Use a code editor (such as **Visual Studio Code** or **Cursor**) to edit a file like `pt.json`.

{% code title="pt-br.json" %}

```json
{
  "Subscribe": "Inscreva-se"
}
```

{% endcode %}
{% endstep %}
{% endstepper %}

### **Add a new language (optional)**

{% stepper %}
{% step %}
Duplicate an existing file (e.g., `en.json`).
{% endstep %}

{% step %}
Rename it using a valid language code (e.g., `de.json`).
{% endstep %}

{% step %}
Replace the values with your translations.
{% endstep %}
{% endstepper %}

### **Repackage the theme**

{% stepper %}
{% step %}
Compress the entire theme folder into a new ZIP file.
{% endstep %}

{% step %}
Upload the updated theme
{% endstep %}

{% step %}
In Ghost Admin, go to (Theme → Change theme → Upload theme).
{% endstep %}

{% step %}
Upload your updated ZIP file.
{% endstep %}
{% endstepper %}

### **Set your site language**

Go to (**General** → **Publication Language**) and enter your language code (e.g., `pt-br`, `es`, `fr`, `ar`, `de`).

### Recommended Tools

To safely edit translation files, always use a code editor that supports UTF-8 encoding and JSON formatting, such as:

* [Visual Studio Code](https://code.visualstudio.com/)
* [Cursor](https://cursor.com/)

{% hint style="danger" %}
Avoid editors like Notepad or Word — they may introduce errors or break JSON formatting.
{% endhint %}