Quick Start

This guide walks you through the whole workflow — install to live translated site. Each step has a note on what to check if something doesn’t go as expected.

If you haven’t installed Omnalingo yet, start with the Installation guide.

---

1. Install and activate Omnalingo

   Upload the plugin via Plugins → Add New → Upload Plugin, select omnalingo.zip, click Install Now, then Activate Plugin. The setup wizard opens and an Omnalingo menu item appears in the sidebar.

   Tip

   The setup wizard is the fastest way through the next three steps — it handles your languages, content, and key in one flow. The steps below show what it sets up (and how to do it by hand). You can re-run the wizard any time from Settings → General.

2. Add your languages and content

   Go to Omnalingo → Settings → General. Under Language Settings, click Add Language, choose your language, set its URL slug (e.g. de), and toggle it Active. Under Sitemap Content Settings, leave the Smart default preset on (or pick content types manually). Click Save All Changes.

   If this goes wrong

   If the language won’t save, check that your database user can create tables — Omnalingo adds a table per target language.

3. Connect your Omnalingo API key

   Go to Omnalingo → Settings → License and click Connect to Omnalingo under One Click Setup — no account or credit card. (You don’t need any external AI key like OpenAI or Claude; the Omnalingo key is all that’s required.) Already have a key? Paste it under Enter an existing key manually and click Save.

   If this goes wrong

   If connecting fails with a network error (rather than an invalid-key message), your server may be blocked from making outbound HTTPS requests — a server-configuration issue to raise with your host.

4. Translate your site

   Open Omnalingo → Translation. Your pages are already listed in the Sitemap with their word counts. Now translate, two ways:

   Translate everything (recommended for a first run): in the AI Auto Translation Status panel, click Enable Auto translate for all — or flip the Auto Translate toggle to Turn On for individual pages. Auto Translate translates the existing content and keeps it in sync whenever you edit a page later, so you can set it once and forget it.

   Translate a single page yourself: open the Live Editor for any page and click Translate page. Omnalingo translates the whole page — a short chat-style progress flow shows what it’s doing while the AI works (a few seconds) — and you can review, accept, or rewrite any string in place.

   If this goes wrong

   If nothing translates, confirm your key is connected under Settings → License. On the free key, check you haven’t used up the 2,000-word allowance — if you have, translate manually in the Live Editor or upgrade to Pro for a language pack.

5. View your translated site

   Open your site and add your language prefix to any URL:

   • French: https://yoursite.com/fr/
   • German: https://yoursite.com/de/
   • Spanish: https://yoursite.com/es/

   You’ll see the page fully translated, and the language switcher lets visitors change languages.

   If this goes wrong

   If the translated URL returns a 404, go to Settings → Permalinks and click Save Changes to refresh the URL rules. If the page loads but some text is still in the original language, that page hasn’t been translated yet — turn on Auto Translate for it or translate it in the Live Editor.

Note

About word counts: the count in the Sitemap is informational — you don’t have to click Count remaining before translating. It mostly matters on the free key (where you have 2,000 words) or when you’re curious how large your site is; with a language pack the number rarely matters, and translating a page updates it anyway.

---

What Comes Next

A few things worth setting up once you have a working translation:

• Glossary (Pro) — lock brand names and key terms to a fixed translation, or leave them untouched. Omnalingo → Settings → AI Settings → Glossary.
• AI context & translation style — tell the AI about your business and set the writing voice and translation freedom so translations sound natural. Omnalingo → Settings → AI Settings.
• Keep translations current — with Auto Translate on, edits re-translate automatically. Otherwise, re-translate the page in the Live Editor after you change it.