How to translate blog posts

In TeleportHQ, once your site has more than one language, every Blog post and Help Center article gets a Content language tab for each language. Open a post, click a language tab, and type the translated title, excerpt, text, tags and SEO text, or click Translate N empty fields to fill them with AI, then save. A field you leave empty shows the main language's text on your site. Categories are translated separately, in Manage Categories.

Before you start#

• Your site needs at least two languages. See How to make your site available in several languages and How to add a language.
• Your project needs the Blog or the Help Center switched on. See How to add a blog to your site.
• Translating with AI uses AI tokens. See What uses AI tokens, and how much?

Translate all posts and articles when you add a language#

1. Add the language from the language button at the top left of the canvas. See How to add a language.
2. In the Add [language] inside the project window, leave Automatically translate blog posts on. While the Help Center is on, Automatically translate help center articles is there too.
3. Click Add followed by the language, for example Add French.

TeleportHQ translates every existing Blog post and Help Center article with AI: the titles, excerpts, text and addresses, and the names and descriptions of your categories. The progress window shows a step for each, for example Blog posts and Help Center articles.

Translate one post#

1. In the left sidebar (the icon column), click Blog, or Help Center.
2. Click the post. The Edit Blog Post panel opens.
3. Under Content language, click the language, for example French. A dot on a tab means nothing is translated in that language yet.
4. Read the line under the tabs: "Editing the French translation. A field left empty shows the English text on the site. Images, status, categories, related posts, author and reading time are shared by every language."
5. Fill in the translated Title, Excerpt and Content, and optionally Tags, Author Bio, Meta Title and Meta Description. The post's French address is made from the translated title.
   • To let AI do it, click Translate N empty fields, for example Translate 7 empty fields. It fills only the empty fields, from the main language.
   • To translate one field, click the translate button beside it (tooltip, for example, Translate the title into French).
6. Click Save Changes.

Translate posts when you change the site's language#

On a site with one language, Change in the language menu moves the whole site to another language, for example from English to German. In the Change the project language to German window, Translate blog posts and Translate help center articles translate your posts and articles with AI, each with its cost in AI tokens shown first. The posts keep their addresses. See How to change the main language or remove a language.

Translate blog categories#

1. In the Blog panel, click Manage at the end of the category pills. The Manage Categories panel opens.
2. Click the language tab you want to translate into. A Translating into badge shows the language, and a line counts how many categories are fully translated, for example "3 of 5 fully translated".
3. Click Translate 2 with AI (the number is how many still need translating), or double-click each name to type its translation.
4. Publish your project again so the translated categories reach your live site.

The nesting, order and pictures of categories are shared by every language: change them on the main language's tab.

Check that it worked#

• In the post's Content language tabs, the language no longer shows a dot.
• On your live site, the French version of a post is at /fr/blog/ followed by its French address, for example /fr/blog/comment-nous-faisons-notre-levain. A post without a French address uses its main address there. See How URLs and SEO work on a multilingual site.
• Your post sitemap lists each language's address of a post. See How to set SEO for a blog post.

Troubleshooting#

The Content language tabs don't appear Your site has only one language. Add a second language first.

Saving jumps back to the main language tab The main language's Title is empty, or another field there has a problem. TeleportHQ says what's missing and switches to that tab. Fix the field, then save.

A field's translate button says "Write the title in English first" AI translates from the main language, so that field must be filled there first.

My translated categories don't show on the live site Category names are saved into your site when you publish. Publish again after translating them.

The language was added as a copy of the main language Your workspace didn't have enough AI tokens, so TeleportHQ added the language without translating it. Translate the posts in each language tab. See What happens when I run out of AI tokens?

Good to know#

• These parts of a post are shared by every language and can only be changed on the main language's tab: images, status, categories, related posts, author, reading time, No Index, Custom Canonical and Custom Redirect.
• Posts you write by hand after adding a language aren't translated by themselves. Use Translate N empty fields in each.
• Blog and Help Center translate the same way: in the post's tabs, in Manage Categories, and with their own switch when you add or change a language.
• Import and export use one column per language and field, named with the language code, for example fr_title or es_content. See How to import or export blog posts.