Troubleshooting

My translation isn't created

Check these in order:

1. Is that content type enabled? Each content type (Articles, Categories, Menu, Modules, Tags, Mail Templates) has its own "Translate ..." toggle, see the matching Configuration article.
2. Does the source item's language match your Source Language setting? The plugin only processes an item if its language matches the Source Language configured on the General tab, exactly as written there.
3. What's your Translation Method? With "Upon Saving", translation happens the instant you save a matching item. With "Batch", nothing happens automatically, use the Batch Translate button in the item list instead.
4. Is the driver configured? Check the Service & API tab: the correct Translation Service is selected and its API key is filled in, see "Configuration - Service & API".

I updated the source item, but the translation still shows the old text

Set Update Existing Translations to "Yes" for that content type. When it's "No", only new items get an initial translation, existing translated items are left untouched so you can edit them freely without the plugin overwriting your changes.

Only some fields got translated

Each content type has its own Translatable Fields setting. Only the fields you select there are sent to the translation service, everything else is copied 1-to-1 from the source item without translation.

The Custom Instructions field doesn't seem to do anything

Custom Instructions PRO version only only apply to the AI-based drivers (OpenAI, Anthropic, Gemini, Mistral, DeepSeek, xAI). It has no effect with Copy, Google Translate, Microsoft Translator, or DeepL, DeepL has its own separate Custom Instructions field on its configuration page.

My API key doesn't work

Make sure the Translation Service on the Service & API tab matches the key you pasted, that the key is copied in full without extra spaces or line breaks, and that the account behind it still has usage credit left with the provider.

Frequently Asked Questions

Do I need the PRO version?

FREE covers the Copy, Google Translate, Microsoft Translator, OpenAI and Mistral drivers, plus translation of Articles (Title and Text) and Categories (Title and Description). PRO adds the DeepL, Google Gemini, Anthropic, xAI and DeepSeek drivers, translation of Menus, Modules, Tags and Mail Templates, the Dictionary feature, more translatable fields for Articles and Categories (Images, Meta Description, Meta Keywords, Note, Custom Fields), Associated Tags and Associated Links, a custom publication state for new translations, and the YOOtheme Pro Builder integration.

What's the difference between "Upon Saving" and "Batch"?

"Upon Saving" translates automatically the moment you save an item that matches your Source Language. "Batch" turns that off and instead adds a Batch Translate button to the toolbar of the relevant list view, so you decide when translations run, useful if you're translating a large amount of existing content and want to control API usage.

Which AI models can I use?

Autolanguage supports the model list published by each provider at the time of your Joomla update. Pick your provider on the Service & API tab and choose a model from the dropdown that appears.

Can I add my own fixed translations for specific words?

Yes, with the Dictionary PRO version only feature. Add a source term, its translation, and optionally restrict it to one target language, the translation service then uses your term instead of translating it itself.

Does Autolanguage translate content that already existed before I installed it?

Not automatically. Existing items only get translated once you save them again, or by using Batch Translate mode to translate them on your own schedule.

Will my custom fields be translated too?

For Articles and Categories PRO version only, yes, add Custom Fields to the Translatable Fields option. Only Text, Textarea and Editor field types are translated, other field types are copied 1-to-1.