Translations
Any article you write in Asky can become a set of language versions that live alongside the original. Asky translates the whole piece, not just the body: the title, the meta description, your CMS fields, and the internal links, so each language arrives as a finished, publishable draft rather than a rough machine translation.
Accessing Translations
Go to Content Library in the sidebar, open a draft, and click Translations in the editor toolbar.
The menu lists the original and every language you have made from it. New translation starts another one. Any draft with a title and a body can be translated, and it does not need to be published first.
| Status | Meaning |
|---|---|
| Queued | The translation is waiting to start |
| Translating | Asky is working on it now |
| Failed | Something went wrong. Hover to see why, then click Retry |
A finished translation shows no progress label. Once you send it to your CMS the row shows its publishing status instead, using the same statuses as the Content Library.
Creating a Translation
Pick a Target Language
Choose the language to translate into. Languages you have already translated this article into are listed but greyed out, marked Already translated. The article’s own language is not in the list at all.
Set the Tone
For the languages marked in the table below, choose a Formality. For an English target you get English spelling instead. Every other language shows no control here. Both are pre-filled from your brand defaults.
Choose Which Custom Fields to Include
Optional. If the draft has CMS fields mapped, open Custom fields to see which of them will be translated, and clear any that should stay in the source language.
Review the Links
Asky lists every internal link in the article next to the URL it will point to in the new language. Edit any target, skip a row to keep the original link, or leave the suggestions as they are.
Start the Translation
Click Start translation. Asky opens the new draft straight away and fills it in while you keep working. It usually takes a minute or two, and you get a notification when it is ready, so you can close the tab.
What Gets Translated
| Part of the Draft | What Happens |
|---|---|
| Title | Translated. The URL slug is regenerated from the translated title |
| Meta description | Translated |
| Body | Translated, with formatting, images, tables, and links kept in place |
| Mapped CMS text and rich-text fields | Translated. You can leave any of them out |
| Alt text on mapped CMS image fields | Translated. The image itself is untouched |
| Numbers, dates, references, and other non-text CMS fields | Copied across unchanged |
| Author, featured image, topic, and content type | Copied from the original |
| Content inside code blocks | Excluded from translation |
Everything is translated together as one document rather than field by field, so terminology stays consistent between the headline, the body, and your CMS fields. The result then goes through a second editing pass that reads it against the original and fixes what machine translation usually gets wrong: idioms taken literally, phrasing that is correct but not what a native speaker would write, and link text that reads awkwardly in the new language. Your brand name is carried through as context, so product and brand names are not translated into something else.
Asky checks the edited version against the plain translation before saving it to ensure your translation is correct and not adding or leaving out anything from the original.
Internal Links
An article that links to your own pages should link to the right language version of those pages. Asky finds the internal links in the draft, looks for the translated version of each one on your site, and shows you the whole list before anything runs.
- Edit any target URL to point somewhere else
- Skip a row to leave that link exactly as it is
- Reset an edited row back to the suggested URL
Links Asky cannot find a translated version for are flagged with a warning and keep their original URL. If the list is empty, or most rows are unresolved, run a scan from Pages so Asky has an up-to-date picture of your site.
External links are never rewritten, and link rewriting applies to the article body rather than to custom CMS fields.
Editing a Translation
A finished translation is an ordinary draft. Open it from the Translations menu and edit the title, meta description, slug, body, and CMS fields exactly as you would the original. Content edits are independent: changing the original afterwards does not change a translation, and the other way round.
The one setting that is shared is the CMS collection. Changing it on any language applies it to every language in the family, and Asky warns you before it does.
Translations always branch off the original article, so a translation cannot itself be translated. Start every language from the source draft.
Publishing Translations
When a draft has translations, the publish button opens Review & publish translations instead of the single-draft flow. Every language gets a row, and every ready row defaults to Save as draft. Switch a row to Publish now, or Re-publish if it is already live, or Skip, then confirm. Rows that are still translating cannot be published until they finish, and rows that failed have to be retried first.
Webflow
Webflow keeps every language as a locale variant of one CMS item, so Asky maps each language onto one of your site locales. The match is usually automatic. Where it is not, pick the locale from the dropdown on that row and Asky remembers the choice for next time. Use Refresh locales after adding a locale in Webflow.
The primary-language article has to reach Webflow first. Webflow creates the item in its primary locale, and every translation is added as a variant of that item. Set the primary-language row to Publish now or Save as draft in the same run, or publish it on its own first.
Two situations need a decision from you:
- The language matches no Webflow locale. The row publishes as its own separate CMS item, flagged as unlinked. Add the locale in Webflow, click Refresh locales, and publish again if you want the languages joined.
- The locale exists in Webflow but not on the item Asky already published. Webflow’s API cannot add a locale to an item that already exists, so open that item in the Webflow Designer, add the locale there, and publish again. Choosing Publish unlinked on the row is the alternative: it publishes as a separate item instead.
See Webflow for connecting and configuring the integration.
WordPress
WordPress.com and self-hosted WordPress have no native link between language versions, so each language publishes as a separate post and Asky says so in the dialog. Use a WordPress multilingual plugin if you need the posts joined.
Sanity
Sanity keeps each language as a separate document and links them for you, so Studio’s language switcher works. See Sanity for the details, including what happens on projects that use field-level localization instead.
When a Translation Fails
A failed translation stays in the Translations menu, marked Failed, with the reason on hover. Click Retry there, or Retry translation on the draft itself. If a translation is still running after about ten minutes, a Restart translation button appears on the draft.
A retry re-runs the same language, but it does not carry over the link rewrites you edited by hand, and formality and English spelling fall back to your brand defaults. If you set any of those by hand, delete the failed language and start it again from the dialog instead of retrying.
Deleting Translations
Deleting a translation removes only that language, and frees it so you can translate the article into it again.
Deleting the original does not delete its translations. They stay in your library as separate articles, unless you tick Delete all language versions in the delete dialog and type DELETE to confirm.
Deleting never removes anything from your CMS. Anything already published stays live, and a fresh translation of the same language publishes as a new item rather than replacing the old one.
Limitations
| Aspect | Limitation |
|---|---|
| One per language | An article has one translation per language. To redo a finished one, delete it and translate again |
| Translating a translation | Not supported. Every language branches off the original |
| Link rewriting | Applies to the article body, not to custom CMS fields |
| Webflow ordering | The primary-language article must reach Webflow before any translation |
Next Steps
- Write the article you want to translate in Creating Content
- Set your default tone and spelling in Brand Profile
- Connect a CMS: Webflow, WordPress or Sanity