Before You Start

This guide covers the Webflow-side installation of Weglot and the initial configuration in the Weglot dashboard. It doesn't cover choosing whether Weglot is the right multilingual approach for your organisation; that is covered in Multilingual Nonprofit Websites: Webflow Native, Weglot, or Google Translate?

What you need before starting:

  • A Weglot account with a plan that covers the languages and word count your site requires
  • A Webflow site on a paid Site plan with a custom domain connected and published (custom code needs a Site plan)
  • Admin access to the Webflow site
  • A clear decision on URL structure, subdomain or subdirectory (covered below)

Step 1: Get Your Weglot API Key

After creating a Weglot account and starting a plan, create a project for the site in the Weglot dashboard. Weglot generates an API key for each project and shows it there.

Copy this key. You'll need it in the next step.

Step 2: Add the Weglot Script to Webflow

There is no native integration between Weglot and Webflow: the connection is a script embed in Webflow's custom code settings, given in Weglot's Webflow setup guide (updated November 2025).

In Webflow, navigate to Site Settings → Custom Code → Head Code.

Add the Weglot initialisation script with your API key, then save and publish the Webflow site. Weglot loads from the <head> so it can intercept and translate content before the page renders.

After publishing, visit your site. A Weglot language switcher widget should appear on the page, at the bottom right by default. If it appears, Weglot is installed and active.

Step 3: Decide on URL Structure (Subdirectory or Subdomain)

This is the most important configuration decision, and Weglot asks for it during project setup, so decide before translating any content.

Subdirectory structure places translated content at a path beneath your main domain: yourcharity.org.uk/fr for French, yourcharity.org.uk/es for Spanish. On Webflow this is the harder setup: Weglot's subdirectory guide tells you not to repoint your main DNS record at Weglot (that would take the site off Webflow) but to email support@weglot.com, who set it up with your records still pointing at Webflow.

Subdomain structure places translated content at a subdomain: fr.yourcharity.org.uk. This is what Weglot's Webflow setup guide leads with: one CNAME record per language.

Either way, Weglot serves indexable translated pages with hreflang tags. The idea that subdirectories inherit the main domain's authority while subdomains start from nothing is SEO folklore: Google's guidance on multi-regional and multilingual sites lists both as workable and ranks neither above the other.

Which to use: the choice is not an SEO one. Neither structure ranks above the other, and Weglot serves indexable pages with hreflang tags either way. What differs is the setup cost and who has to be involved. A subdomain you can do yourself: one CNAME record per language, the same process described in How to Connect Your Domain to Webflow via DNS. A subdirectory keeps every language under the one domain, but it cannot be self-served on Webflow, because Weglot's support team has to configure it and your DNS has to keep pointing at Webflow. Decide on those grounds.

Step 4: Add Your Languages in the Weglot Dashboard

Weglot asks for your original and target languages when you create the project; add more later under Translations → Languages.

Weglot generates translations page by page as someone visits it in a translated language, including search engine bots. Each word counts once per language (an 8,000-word site in three languages is about 24,000 translated words), page titles and alt text count too, and the total is a fixed plan limit that does not renew (Weglot pricing, September 2026), so the count only grows.

Step 5: Review and Edit Translations

Machine translation requires human review before it's published. Medical terms, legal language, safeguarding terminology, programme names and sector-specific vocabulary are where it commonly produces errors.

In Weglot, go to the Translation List, select the language pair and edit the right-hand column. Changes are saved automatically and displayed on your website, without a Webflow publish.

What to prioritise in the review:

  • Navigation labels: these appear on every page
  • Homepage hero text and primary calls to action
  • Programme or service descriptions
  • Contact page content
  • Any legally significant language: privacy policy, terms, safeguarding statements
  • Donation page content

Step 6: Configure the Language Switcher

Weglot adds a language switcher widget automatically. In the Weglot dashboard under Settings → Language switcher, choose flags, language codes or full names, and a list or dropdown, and add custom CSS.

Ensure the switcher has sufficient colour contrast against the page background: 4.5:1 for normal-size text under WCAG 2.2 success criterion 1.4.3 Contrast (Minimum), Level AA.

To place it somewhere specific, such as the header navigation, add <div id="weglot_here"></div> where you want it in a Webflow Embed element.

Step 7: Exclude Pages or Content from Translation

Weglot translates everything it can access by default, which increases your word count and plan costs.

In the Weglot dashboard under Settings → Translation exclusions, add URL rules (a "Starts with" rule for /blog/ keeps blog content in English only) or CSS selectors for specific blocks.

Decide on exclusions before the translated pages are first visited: an exclusion added later does not delete translations already generated unless you tick that option in a URL rule.

Step 8: Test Before Promoting

Before publicising the translated version, test thoroughly:

  1. Visit the site and switch to each translated language
  2. Navigate through all core pages and confirm translated content appears correctly
  3. Check that forms still work in translated mode
  4. Check that the donation form or button works correctly
  5. Confirm the URL structure matches your configuration
  6. Test on mobile: confirm the language switcher is accessible at small screen widths
  7. Run a keyboard navigation test: can you reach and activate the switcher without a mouse?

What Weglot Doesn't Translate

Text within images. Weglot translates HTML text, not image content. Use HTML text over images rather than text embedded in image files. If an image must differ by language, Weglot can swap in a translated file.

Donation platform content. The donation modal or iframe is served by the donation platform, not your Webflow site, and Weglot cannot translate an iframe unless you control it and install the snippet inside it. If translated donation forms are required, configure this within the platform itself.

PDF documents. Linked PDFs remain in their original language; the same media swap can link a translated PDF you have produced separately.

Further Reading