# Translating with WPML

To enable string translations you will have to install the [WPML string translation ](https://wpml.org/download/wpml-string-translation/?aid=733309\&affiliate_key=bOw0TPeU6A7s\&dr=asp)module. The WPML String Translation module is part of the [Multilingual CMS](https://wpml.org/purchase/?aid=733309\&affiliate_key=bOw0TPeU6A7s\&dr=asp) and [Multilingual Agency](https://wpml.org/purchase/?aid=733309\&affiliate_key=bOw0TPeU6A7s\&dr=asp) account types.

### Translating via String Translation menu

{% hint style="warning" %}
We highly recommend checking out the official WPML [String Translation Guide](https://wpml.org/documentation/getting-started-guide/string-translation/?aid=733309\&affiliate_key=bOw0TPeU6A7s\&dr=asp) as well as the [Getting Started Guide](https://wpml.org/documentation/getting-started-guide/?aid=733309\&affiliate_key=bOw0TPeU6A7s\&dr=asp) to learn how WPML works
{% endhint %}

To activate String Translations, start by downloading and installing it from your [WPML.org account](https://wpml.org/account/?aid=733309\&affiliate_key=bOw0TPeU6A7s\&dr=asp) in the **Downloads** section.&#x20;

1\) Place the search shortcode somewhere visible on any page (or use the widget).

2\) Open up that page, so the translations will get registered first. This step is **very important**, otherwise the string translations may not show up!

3\) Open up the **WPML -> String translation** menu

![WPML String Translation Menu](http://i.imgur.com/9bfzlvN.png)

4\) Change the **Select strings within domain** option to "ajax-search-pro", so only strings from Ajax Search Pro are visible

<figure><img src="https://1706764988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L9jkFgNo4lpUof35gvS%2Fuploads%2FiOA5U8n8TdINqtQ8Uixe%2Fimage.png?alt=media&#x26;token=ab29df85-4ffd-4eb2-8f8f-81b32a8ec370" alt=""><figcaption><p>Selecting the search domain</p></figcaption></figure>

5\) Now the list will display all ajax search pro related translatable texts.

{% hint style="warning" %}
Please note that the number **after each text** in the Name column represents the search instance. This way different search instances with the same text can have different translations.
{% endhint %}

<figure><img src="https://1706764988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L9jkFgNo4lpUof35gvS%2Fuploads%2FOpDFgPDJaCutm9lJusb8%2Fimage.png?alt=media&#x26;token=c4ab2954-dfae-493d-b21f-de51fc4c4fc1" alt=""><figcaption><p>Translations for each search instance</p></figcaption></figure>

6\) Click on the + sign under the language flag to begin the translation to the selected string to that language:

<figure><img src="https://1706764988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L9jkFgNo4lpUof35gvS%2Fuploads%2FNmoSWe1Y25ajWdgtjrS7%2Fimage.png?alt=media&#x26;token=47fab32c-a3df-4156-aae8-acf78c77d547" alt=""><figcaption></figcaption></figure>

7\) Pressing enter or clicking outside the window will save the translation.

For more information and detailed guies please check the [official WPML string translation guide](https://wpml.org/download/wpml-string-translation/?aid=733309\&affiliate_key=bOw0TPeU6A7s\&dr=asp).

### Translating via Translation Management menu

Alternatively the translations are also available under the Translation Management menu as well. It offers a quick access to the string translations.

Scroll down to the **Other texts (Strings)** section, choose the `ajax-search-pro` domain, select the strings and on the bottom right corner click on **Translate your conten**t button to begin the translations.

<figure><img src="https://1706764988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L9jkFgNo4lpUof35gvS%2Fuploads%2F91snUovk6OdMAoMQ57G4%2Fimage.png?alt=media&#x26;token=1587bdfc-b54b-43bd-8103-62935d6e791e" alt=""><figcaption><p>Selecting translations via the Translation Manager</p></figcaption></figure>

You will be taken to the bottom of the screen where you can choose the method for each string to translate.

<figure><img src="https://1706764988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L9jkFgNo4lpUof35gvS%2Fuploads%2FaV29w1k5zY5rXCfwt8jc%2Fimage.png?alt=media&#x26;token=22133c90-f42b-4d19-835c-22ef37486cd1" alt=""><figcaption></figcaption></figure>

The strings then will be sent for translation and a notification is sent to the assigned translator (if selected).

The assigned translation can be completed under the **Translations** menu.

<figure><img src="https://1706764988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L9jkFgNo4lpUof35gvS%2Fuploads%2FKgWnztzWECAImQZPLiOd%2Fimage.png?alt=media&#x26;token=01a695ca-47fc-45f8-8deb-26fd98c175bc" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.ajaxsearchpro.com/translating-components/translating-with-wpml.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
