> For the complete documentation index, see [llms.txt](https://ninjateam.gitbook.io/filebird/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ninjateam.gitbook.io/filebird/addons/filebird-document-library/translations.md).

# Translations

Ways to translating FileBird Document Library

To fully translate FileBird Document Library, you need to translate both of user interface and Gutenberg block.

### Method 1: Use Loco Translate to generate translation files

If your language is not yet supported, you can manually translate words by following this guide.

**Step 1.** Firstly, please install [Loco Translate](https://wordpress.org/plugins/loco-translate/) on a WordPress site. This plugin is to help you generate the required JSON files. And when you're done, you can just remove it from your site.

**Step 2.** Then go to Loco Translate > Plugins > FileBird Document Library and Add **New language**.

<figure><img src="https://3041978267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyIWF9CNHLQhdztdjt8Uo%2Fuploads%2FCWL1rM59j1OjldqPLWFR%2Ffilebird-document-library-add-new-language.png?alt=media&amp;token=8d99b08f-5cae-4ace-b511-82ca9a82e07d" alt=""><figcaption></figcaption></figure>

**Step 3.** Choose your language and click **Start translating**.

<figure><img src="https://3041978267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyIWF9CNHLQhdztdjt8Uo%2Fuploads%2FkywdbhX5kfszTmkWehI9%2Ffilebird-document-library-start-translating.png?alt=media&amp;token=872b3f05-1fc0-4a26-a6ac-dcb6dbf781d2" alt=""><figcaption></figcaption></figure>

**Step 4.** Translate all strings and click **Save**!

<figure><img src="https://3041978267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyIWF9CNHLQhdztdjt8Uo%2Fuploads%2F9iXCx9Tvi7BZXpqngPOP%2Ftranslate-strings.png?alt=media&amp;token=d72aa476-1be4-4b6f-92e1-ae7f778e43ec" alt=""><figcaption></figcaption></figure>

**Step 5.** After that, please download all .po, .mo, .json files and put them in the "languages" folder of our plugin.

* To download **PO** and **MO** files, you can use the built-in options in Loco Translate.

<figure><img src="https://3041978267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyIWF9CNHLQhdztdjt8Uo%2Fuploads%2FfIUA1UMUFlbrfy4HTa4L%2Fdownload-po-mo.png?alt=media&amp;token=70db92fa-e9c9-48b7-a846-9d17d8c72782" alt=""><figcaption></figcaption></figure>

* To download **JSON** files, you can use a secure file manager plugin like [Filester](https://wordpress.org/plugins/filester/).

<figure><img src="https://3041978267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyIWF9CNHLQhdztdjt8Uo%2Fuploads%2FsgnqJMuh90lS0DmAyOoa%2Ffile-manager-3-json-files.png?alt=media&amp;token=f14adb05-ea50-4292-abd5-8a7a50ddeb0a" alt=""><figcaption></figcaption></figure>

When you add them to the **languages** folder of the FileBird Document Library plugin directory, please make sure you have 5 files: 1 .po, 1 .mo and 3 .json files. Please refer to the screenshot below.

<figure><img src="https://3041978267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyIWF9CNHLQhdztdjt8Uo%2Fuploads%2FxtbGkesWFoD6jTY8VREX%2Ffolder-languages.png?alt=media&amp;token=e963e5c1-7154-4353-9208-c853fab89314" alt=""><figcaption></figcaption></figure>

### Method 2: Use WPML

You can use WPML to translate the gallery elements.

<figure><img src="https://3041978267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyIWF9CNHLQhdztdjt8Uo%2Fuploads%2FjPTeN3ET0dAg4FABwSHU%2FWPML%20translation%20management.png?alt=media&amp;token=fc7627b0-1e47-4527-a7c3-a267388c2a2f" alt=""><figcaption></figcaption></figure>

### Method 3: Programmatically create a POT file&#x20;

If you don't want to use Loco Translate, you can opt for a developer-friendly workaround. Please [follow these developer resources to make POT](https://developer.wordpress.org/cli/commands/i18n/make-pot/).

### Method 3: Request live translate feature

**Live translate** is not something currently supported in our plugin. But it has been brought up a few times, and at some point if we got more requests, we would love to add this feature.

You can [upvote this suggestion](https://feedbo.io/board/filebird-document-library/#add-live-translate-options-to-translate-gutenberg-block) to let us know that you need live translate for FileBird Document Library!

*Happy translating\~*&#x20;