---
agentTools:
  projectIndex: https://help.localizejs.com/llms.txt
---

# Translate WordPress

This WordPress application integration guide shows you how to translate WordPress applications in a few easy steps. Follow this tutorial to create a multilingual WordPress application translated to other languages for your international customers.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/7229b59-WordPress_logo.png",
        "2000px-WordPress_logo.svg.png",
        "2000"
      ],
      "align": "center"
    }
  ]
}
[/block]

Below is a step by step guide for integrating [Localize](https://app.localizejs.com/) into your WordPress application.

If you do not have a Localize Project yet, [signup here](https://app.localizejs.com/signup)!

## 1. Login to your WordPress admin site

Then navigate to the **Plugins** area.

## 2. Select "Add New"

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/172f933-add-new.png",
        "add-new.png",
        798
      ],
      "align": "center",
      "sizing": "70% "
    }
  ]
}
[/block]

## 3. Search for "localizejs"

Or click this link: ["Localize - Website Translation Integration" plugin](https://wordpress.org/plugins/localizejs/)

![](https://files.readme.io/6e1664e-Search_for_Localizejs.png "Search for Localizejs.png")

## 4. Click "Install Now"

After you find the Localize plugin, click **Install Now**. This will install the plugin into your site.

![](https://files.readme.io/83730e6-Install_Now.png "Install Now.png")

## 5. Click "Activate"

![](https://files.readme.io/e7bad66-Activate.png "Activate.png")

## 6. Select "Localize" to display the settings

Select the **Localize** plugin settings link from the left navbar.

![](https://files.readme.io/3f7443a-Settings_Link.png "Settings Link.png")

If you don't already have it, find your **Project key** from the [Localize Dashboard](https://app.localizejs.com/project).

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/ad8ff040b1a11b757a8390a5bee04d06a1a846841766658a3ef111753a271ef9-Find_Project_Key_v2.jpg",
        "Find Project Key.png",
        ""
      ],
      "align": "center"
    }
  ]
}
[/block]

## 7. Add your Project Key

Add your **Project Key** and click "Save Changes".

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/35d292782f548271e4340f8ea2afbff949ffabdfa66b6a6f52bde43d3ab07046-Wordpress_Plugin_Settings_cropped.jpg",
        "Localize WP Settings.png",
        ""
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

## SEO Options

### Subdirectories

Using subdirectories to optimize your page rankings for a website that is translated into multiple languages is one of the recommended [best practices for SEO](https://help.localizejs.com/docs/search-engine-optimization-seo) (e.g. example.com/es, example.com/fr).

If you would like to set up your WordPress site to use a separate subdirectory for each target language in your site, select the **Subdirectory** option. Then click "Save Changes".

### Subdomains

Using subdomains is another recommended [best practice for SEO](https://help.localizejs.com/docs/search-engine-optimization-seo) (e.g. es.example.com, fr.example.com).

If you would like to set up your WordPress site to use a separate subdomain for each target language in your site, select the **Subdomain** option. Then click "Save Changes". There is no need to create new pages in WordPress for the target language content.

> 📘 Set up Subdomains in your DNS
>
> To use the subdomains option, you'll need to create the subdomains in your DNS settings. Simply point the target language subdomains (e.g. es.example.com) to your main domain (e.g. example.com).

## Initialization Options

You can toggle on/off the following options to be sent when Localize is initialized.

* [allowInlineBreakTags](https://developers.localizejs.com/docs/library-api#allowinlinebreaktags)  - if checked, whenever you have a `<BR>` element in your content, Localize will not break up the parent element's content.
* [autoApprove](https://developers.localizejs.com/docs/library-api#autoapprove)  - if checked and you have AI translations enabled, any new phrases found on your website will be automatically translated.
* [retranslateOnNewPhrases](https://developers.localizejs.com/docs/library-api#retranslateonnewphrases)  - if checked, Localize will automatically update your web page with newly translated content.

## 8. Reload your website

1. Visit your website in a browser.
2. Select one of your target languages using the language-switching widget.
3. Refresh the page.
4. Lather, rinse, repeat, for each page on your site.

Localize will automatically begin to detect new content on the pages that you visit, and will bring it into your dashboard.

## 9. Approve phrases

Then head on over to the [Manage Phrases page](https://app.localizejs.com/phrases?page=1\&state=pending\&pageFilter=all) to [approve phrases](https://help.localizejs.com/docs/approve-content-for-translation) in the Localize dashboard.

![](https://files.readme.io/7de12cc-Pending_Phrases_Bin.png "Pending Phrases Bin.png")

## 10. Phrases not showing up?

If you are not seeing phrases show up in your Pending bin in the Localize dashboard, [follow the troubleshooting instructions here](https://help.localizejs.com/docs/my-dashboard-is-empty).

***

**Need Help?**\ <a class="open-widget">Contact support</a> for custom integration help or troubleshooting!