WP The Moon Logo
WP The Moon

AI Translator for Polylang

Use the Polylang-specific AI Translator addon to create draft translations for posts and pages.

AI Translator for Polylang

AI Translator for Polylang is a WPTheMoon addon for creating AI-generated draft translations and linking them through Polylang.

It is designed only for sites that use Polylang.

Requirements

Before using the addon, install and activate:

  • AI Generator.
  • Polylang.
  • WPTheMoon AI Translator for Polylang.

You also need a valid WPTheMoon API Key in AI Generator > Settings.

Download location

Download the addon from its addon detail page when it is available:

/addons/ai-translator-polylang

This docs page explains usage. It is not the download page.

Open the translator

After activation, open:

AI Generator > AI Translator

The page lets you choose:

  • Source language.
  • Target language.
  • Post type: posts or pages.
  • Optional title search.

Translate content

  1. Choose the source language and target language.
  2. Choose Posts or Pages.
  3. Click Load Content.
  4. Select the items you want to translate.
  5. Click Translate Selected.

The addon creates target-language draft posts or pages. It does not publish translations automatically.

What gets translated

Version 1 supports:

  • Post and page titles.
  • Main content.
  • Excerpts.
  • Slugs.
  • Categories.
  • Tags.

The translation service is instructed to preserve Gutenberg block comments, HTML, shortcodes, URLs, CSS classes, IDs, data attributes, and code snippets.

Existing translations

If Polylang already has a translation for the selected target language, the addon skips that item.

This prevents accidental overwrites.

Polylang connection

After a draft translation is created, the addon:

  • Sets the target language with Polylang.
  • Links the original post and translated draft as translations.
  • Links translated categories and tags when possible.
  • Stores WPTheMoon translation metadata on the draft.

What is not supported in version 1

Version 1 does not support:

  • WPML.
  • TranslatePress.
  • Theme strings.
  • Plugin strings.
  • WordPress menus.
  • Automatic publishing.
  • Full-site automatic translation.

For WPML or TranslatePress, use a dedicated addon when one becomes available.

Troubleshooting

The AI Translator page is missing

Check that AI Generator, Polylang, and the addon are all active.

The addon says Polylang is missing

Install and activate Polylang, then reload WordPress admin.

Translation fails because the API Key is missing

Go to AI Generator > Settings and save your WPTheMoon API Key.

A post is skipped

The target language likely already has a Polylang translation. Open the existing translation from the status column.

The translated draft needs edits

That is expected. Review the draft for accuracy, formatting, links, brand tone, and SEO details before publishing.