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

How to Edit or Add a Translation

1

Unzip the theme on your computer.

2

Open the "locales" folder inside the theme directory.

3

Use a code editor (such as Visual Studio Code or Cursor) to edit a file like pt.json.

pt-br.json

{
  "Subscribe": "Inscreva-se"
}

Add a new language (optional)

1

Duplicate an existing file (e.g., en.json).

2

Rename it using a valid language code (e.g., de.json).

3

Replace the values with your translations.

Repackage the theme

1

Compress the entire theme folder into a new ZIP file.

2

Upload the updated theme

3

In Ghost Admin, go to (Theme → Change theme → Upload theme).

4

Upload your updated ZIP file.

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

• Cursor

Avoid editors like Notepad or Word — they may introduce errors or break JSON formatting.