---
title: "Wagtail Localize: Multilingual Django Websites"
description: "Build multilingual Django websites with Wagtail Localize ✅ Easy setup, translation workflows & SEO best practices in one tutorial!"
canonical_url: "https://www.blueshoe.io/blog/wagtail-localize-tutorial-multilingual-django-websites/"
---

> Index of every page on this site: [llms.txt](https://www.blueshoe.io/llms.txt)

Want to build a multilingual website with Django? With Wagtail Localize, it's fast and developer-friendly. This powerful extension for the Wagtail CMS gives you full control over your translations – right inside the admin interface.

![Wagtail Localize: multilingual websites with django](https://www.blueshoe.io/img/blog/wagtail-django.svg)

<global-title :size="lg" className="mb-5">

What is Wagtail Localize?

</global-title>

<global-paragraph>

[Wagtail](https://www.blueshoe.io/technologies/wagtail-cms/) is a flexible, modern CMS for Django. If you’re building multilingual websites, [Wagtail Localize](https://wagtail-localize.org/stable/) makes it easy to manage content and translations – manually or automatically.

</global-paragraph>

<global-paragraph>

With Wagtail Localize, you can:

</global-paragraph>

<global-block className="ul-disk,mb-4">

- Manage multilingual content directly in the Wagtail admin
- Use manual or machine translation
- Define translation workflows and optimize content per locale
- Build SEO-friendly, multilingual sites with ease

</global-block>

<global-button :color="blue" :label="Ready to launch your Wagtail project? Discover how Wagtail makes your web projects faster, more flexible, and easily scalable." :target="_blank" :url="/technologies/wagtail-cms/" className="mb-6">



</global-button>

<global-title :size="lg" className="mb-5">

Installation & Getting Started

</global-title>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

1. Install Wagtail Localize

</global-title>

<global-paragraph>

Run the installation via pip:

</global-paragraph>

<blog-code className="mb-5">

```python
pip install wagtail-localize
```

</blog-code>

<global-paragraph>

Then add the required packages to your INSTALLED_APPS in settings.py:

</global-paragraph>

<blog-code className="mb-5">

```python
INSTALLED_APPS = [
    "wagtail_localize",
    "wagtail_localize.locales",  # Enables the management of multilingual content
    "wagtail.contrib.modeladmin",
    *INSTALLED_APPS,
]
```

</blog-code>

<global-paragraph>

Now run the migrations:

</global-paragraph>

<blog-code className="mb-5">

```python
python manage.py migrate wagtail_localize
```

</blog-code>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

2. Configure Your Languages

</global-title>

<global-paragraph>

Set up the supported languages in settings.py:

</global-paragraph>

<blog-code className="mb-5">

```python
from django.utils.translation import gettext_lazy as _

LANGUAGES = [
    ("en", _("English")),
    ("de", _("Deutsch")),
    ("fr", _("Français")),
]

WAGTAIL_CONTENT_LANGUAGES = LANGUAGES
```

</blog-code>

<global-paragraph>

Activate internationalization in Wagtail:

</global-paragraph>

<blog-code className="mb-5">

```python
WAGTAIL_I18N_ENABLED = True
```

</blog-code>

<global-title :size="lg" className="mb-5">

Managing Multilingual Pages in Wagtail

</global-title>

<global-paragraph>

Wagtail uses Locales to organize language versions. It automatically creates separate versions for each language, all accessible via the admin UI.

</global-paragraph>

![Managing multilingual pages in Wagtail](https://www.blueshoe.io/img/blog/mehrsprachige-Seiten-verwalten-in-Wagtail.png)

<global-paragraph>

To create custom pages in Wagtail, just use the regular Page model.

</global-paragraph>

<global-paragraph>

Example: multilingual custom page

</global-paragraph>

<blog-code className="mb-5">

```python
from wagtail.models import Page
class CustomPage(Page):
    pass
```

</blog-code>

<global-paragraph>

This page model is automatically handled by Wagtail Localize and can be added in different languages.

</global-paragraph>

![Page menu in Wagtail Localize](https://www.blueshoe.io/img/blog/wagtail-localize-seitenmenue.png)

<global-paragraph>

You’re all set to manage your first multilingual pages – but that’s just the beginning.

</global-paragraph>

<global-title :size="lg" className="mb-5">

When to Use TranslatableMixin?

</global-title>

<global-paragraph>

FWant to translate snippets or custom models? Then you’ll need to use [TranslatableMixin](https://wagtail-localize.org/stable/tutorial/3-content/).

</global-paragraph>

<global-paragraph>

Example: multilingual person snippet:

</global-paragraph>

<blog-code className="mb-5">

```python
from wagtail.snippets.models import register_snippet
from wagtail_localize.models import TranslatableMixin
from django.db import models
from wagtail.admin.panels import FieldPanel
from django.utils.translation import gettext_lazy as _

@register_snippet
class Person(TranslatableMixin, models.Model):
    first_name = models.CharField(max_length=200)
    last_name = models.CharField(max_length=200)
    email = models.EmailField(blank=True, null=True)
    job_function = models.CharField(_("Function"), max_length=400, blank=True, null=True)
    job_function_international = models.CharField(_("Function international"), max_length=400, blank=True, null=True)
    image = models.ForeignKey("wagtailimages.Image", null=True, blank=True, on_delete=models.SET_NULL, related_name="+")
    phone = models.CharField(_("Phone"), max_length=200, blank=True, null=True)
    mobile = models.CharField(_("Mobile"), max_length=200, blank=True, null=True)
    country = models.CharField(_("Country"), max_length=200, blank=True, null=True)

    panels = [
        FieldPanel("first_name"),
        FieldPanel("last_name"),
        FieldPanel("email"),
        FieldPanel("job_function"),
        FieldPanel("job_function_international"),
        FieldPanel("image"),
        FieldPanel("phone"),
        FieldPanel("mobile"),
        FieldPanel("country"),
    ]

    def __str__(self):
        return f"{self.first_name} {self.last_name}"
```

</blog-code>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

Common use cases:

</global-title>

<global-block className="ul-disk,mb-4">

- Translating team member profiles
- Multilingual product descriptions
- Locale-specific configuration settings

</global-block>

<global-title :size="lg" className="mb-5">

Best Practices with Wagtail Localize

</global-title>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

1. Keep Your Language Versions Consistent

</global-title>

<global-block className="ul-disk,mb-4">

- Maintain the same structure across languages
- Translate SEO content like page titles and meta descriptions

</global-block>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

2. Optimize for Multilingual SEO

</global-title>

<global-block className="ul-disk,mb-4">

- Use hreflang tags to help search engines match the right language
- Structure your URLs with language prefixes, e.g., /en/about/ instead of /about-en/

</global-block>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

3. Don’t Forget Performance

</global-title>

<global-block className="ul-disk,mb-4">

- Enable caching to serve frequently translated content faster

</global-block>

<global-button :color="blue" :label="Use Wagtail for powerful multilingual sites – Learn more" :target="_blank" :url="/technologies/wagtail-cms/" className="mb-6">



</global-button>

<global-title :size="lg" className="mb-5">

Your Start with Wagtail Localize

</global-title>

<global-paragraph>

With Wagtail Localize, going multilingual is simple. From setup to translation and SEO optimization, it’s a powerful tool for any Django-based website.

</global-paragraph>

<global-paragraph>

Use these best practices and start building robust, multilingual experiences today!

</global-paragraph>

<global-title :size="lg" className="mb-5,mt-8">

Frequently Asked Questions

</global-title>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

1. What is Wagtail Localize and why should I use it?

</global-title>

<global-paragraph>

Wagtail Localize is a powerful translation extension for Wagtail CMS. It lets you manage multilingual content directly in the admin, streamline translation workflows, and optimize pages for international SEO.

</global-paragraph>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

2. How do I install Wagtail Localize in my Django project?

</global-title>

<global-paragraph>

Installation takes just a few steps:

</global-paragraph>

<global-block className="ul-disk,mb-4">

- Install the package: pip install wagtail-localize
- Add it to your INSTALLED_APPS
- Run migrations with python manage.py migrate wagtail_localize

</global-block>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

3. Can I use automatic translations with Wagtail Localize?

</global-title>

<global-paragraph>

Yes! Wagtail Localize supports both manual and machine translations. You can integrate tools like DeepL or Google Translate for auto-translation.

</global-paragraph>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

4. How does language management work in Wagtail?

</global-title>

<global-paragraph>

Wagtail uses a Locale system to organize content. Each language version gets its own page structure, all managed within the Wagtail admin interface.

</global-paragraph>

<global-title :size="md" className="mb-5" :color="text-bs-blue" :font="font-oswald" :tag="h3">

5. Is Wagtail Localize SEO-friendly?

</global-title>

<global-paragraph>

Absolutely. Wagtail Localize supports multilingual SEO best practices like:

</global-paragraph>

<global-block className="ul-disk,mb-4">

- <hreflang>

tags

</hreflang>
- Clean, language-specific URLs
- Custom meta titles & descriptions per locale

</global-block>

## Sitemap

See the full [sitemap](https://www.blueshoe.io/sitemap.md) for all pages.
