Skip to Content
Content LibraryTranslations

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.

StatusMeaning
QueuedThe translation is waiting to start
TranslatingAsky is working on it now
FailedSomething 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.

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 DraftWhat Happens
TitleTranslated. The URL slug is regenerated from the translated title
Meta descriptionTranslated
BodyTranslated, with formatting, images, tables, and links kept in place
Mapped CMS text and rich-text fieldsTranslated. You can leave any of them out
Alt text on mapped CMS image fieldsTranslated. The image itself is untouched
Numbers, dates, references, and other non-text CMS fieldsCopied across unchanged
Author, featured image, topic, and content typeCopied from the original
Content inside code blocksExcluded 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.

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

AspectLimitation
One per languageAn article has one translation per language. To redo a finished one, delete it and translate again
Translating a translationNot supported. Every language branches off the original
Link rewritingApplies to the article body, not to custom CMS fields
Webflow orderingThe primary-language article must reach Webflow before any translation

Next Steps

Last updated on