The language strings for UpStream are located in 3 places:

1. The main UpStream plugin
2. The UpStream extensions
3. The UpStream settings

In this guide, we’ll show you how to translate the UpStream extensions.

We recommend Poedit as a way to translate UpStream. Here’s how the translation process works:

- Download Poedit from [poedit.net](https://poedit.net)

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ1lPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f3954dbfd1b0d21f20d438b5926c90429465f64f/Screen-Shot-2017-06-29-at-4.05.41-PM.png)

- Run the installation script for Poedit on your desktop. Click “Create New Translation”.

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdjROIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1369cfd946e9bf84ae8fd669d69fc65ac6116ff2/1.png)

- [Download UpStream to your desktop](https://downloads.wordpress.org/plugin/upstream.latest-stable.zip?utm_campaign=download&utm_medium=button&utm_source=website).
- Select one of the existing .po files from the /languages/ folder.

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdjhOIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--12b3b7edf71b119e9cc14c2058b84f1011f878c1/2.png)

- Choose the language for your translation:

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ0FPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--40115c8d6bfd1ccd563abb4a6c5bab9179027e19/3.png)

You will see a list of all the English translations. On the right-hand side there’s a blank space waiting for your translation:

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ2NPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f7505646b2f7d27016bc005f9cb119bb6e7ba7a4/Screen-Shot-2017-06-29-at-4.08.34-PM.png)

- At the bottom of the screen, you can enter your translation text into the “Translation” field:

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ0VPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--29c405922f8a2f15a652cf794d9c4d6913d00897/4.png)

- PoEdit is a particularly useful tool because it will automatically give you translation suggestions:

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ0lPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f3ee1e8edf5e7e0ca755d2fa299ecacdabc653c6/5.png)

- When you’re finished, click “Save” in Poedit:

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ2dPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--856dc96c404d0e04125578e89023b65edd29c817/Screen-Shot-2017-06-29-at-4.10.41-PM.png)

- Poedit will export both a .po and an .mo file for you.
- Place these in the /wp-content/languages/upstream/ folder. Create this folder if it doesn’t exist.

IMPORTANT: please note that this folder is not inside the main /upstream/ plugin folder. If you place your translation files there, they will be deleted when the UpStream plugin updates.

- For the files, use the naming structure you can see below. [You can find a list of locale identifiers here](https://gist.github.com/jacobbubu/1836273).

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ01PIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0c2395e2d3110b4490ab6646adea030abf714ce7/6-e1527712003893.png)

- If your site is running your language (in this case, Spanish), UpStream will automatically detect your new files and change to your language:

![image](https://support.kelsiem.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ1FPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9fb89b015cfaa720669200bf936d713d07d86664/7.png)