> ## Documentation Index
> Fetch the complete documentation index at: https://docs.makeswift.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Localization

> Localization involves adapting a website's content, layout, and functionality to meet the cultural, linguistic, and regulatory requirements of a specific target audience or geographic region. It goes beyond translation to ensure the website is effective and engaging for the local audience.

## Adding locales

Makeswift's localization feature allows you to manage localized versions of your web pages directly within the builder. You'll need to configure your locales in code, and then add them into the Locales settings within Makeswift to enable the locale toggle in the builder.

<Check>
  Localization is available on all Makeswift plans. Refer to your
  [plan](/product/workspace/plans) for full details and upgrade options if you
  need more locales.
</Check>

<Steps>
  <Step title="Add locales in the Makeswift builder">
    Click "Settings" and go to the "Locales" tab.

    <Frame>
      <img src="https://mintcdn.com/makeswift/HbNRkL0I6rDIzVGb/images/makeswift-settings-locales.png?fit=max&auto=format&n=HbNRkL0I6rDIzVGb&q=85&s=9b0073fbd589a21d7edc197132a7fc7d" alt="Settings Locales" width="840" height="584" data-path="images/makeswift-settings-locales.png" />
    </Frame>

    To add a new locale, click the "Add locale" button. To modify or delete existing locales, hover over the locale and use the edit or delete button. The default locale cannot be deleted.

    When adding or editing a locale, you can specify its language and region. A locale can apply to a single geographic region, or all regions. For sites with localized domain names, you can optionally specify a domain URL for each locale. For example, *mysite.com* might use *mysite.co.uk* and *mysite.com.au* for the United Kingdom and Australia, respectively.
  </Step>

  <Step title="Configure locales in your Next.js config">
    For detailed instructions on setting up locales, see our [developer docs](/developer/app-router/localization) on localization.
  </Step>

  <Step title="Edit your pages in the builder">
    Once you've finished setting up your locales in Makeswift and in your codebase, you should be able to switch to different locales using the locale switcher in the builder browser bar.

    <Frame>
      <img src="https://mintcdn.com/makeswift/AOijlpVp0npNQ8wB/images/localization-locales-switcher.png?fit=max&auto=format&n=AOijlpVp0npNQ8wB&q=85&s=e1feaa1d95c6e5f054dc4493198e11fa" alt="Manage locales in settings" width="874" height="850" data-path="images/localization-locales-switcher.png" />
    </Frame>

    When making changes in a different locale you can override any property, including the page's pathname, metadata, and SEO tags.

    <Info>
      You can customize the path for each page in each locale. For example, if you
      have a company page at `example.com/company`, you can create the Spanish
      version of the page at `example.com/es/compania` or `example.es/compania`.
    </Info>
  </Step>
</Steps>

## Localization fallback

Localized pages inherit the design and content of the default locale when initially created.

To customize a page for a specific locale, click the “Edit for this locale” button. Any changes you make will be saved only for the localized version of the page.

<Frame>
  <img src="https://mintcdn.com/makeswift/pZUQIXY0VZyiTaM2/images/developer/guides/localization/edit-locale-message-2.jpeg?fit=max&auto=format&n=pZUQIXY0VZyiTaM2&q=85&s=4dfb1605297668cf47d430fa93111263" alt="Edit for this locale button" width="1600" height="900" data-path="images/developer/guides/localization/edit-locale-message-2.jpeg" />
</Frame>

## Localized global components

You can also localize a global component. To do this, edit a global component within a localized page and then save the global component.

<Note>
  You must save a global component in a locale before switching and editing it
  in another locale.
</Note>