The **Dynamic Phrases** feature makes it easy to identify phrases that contain dynamic content (such as dates, names, email addresses, etc.) so they can be merged into a single phrase for translation - right from within the Localize dashboard! ![](https://files.readme.io/ae5aff3-Define_Vars_4_to_1.png "Define Vars 4 to 1.png") As a result, you don't have to ask your developers to [add `` tags in your HTML](https://developers.localizejs.com/docs/using-html-syntax-to-prepare-phrases), and your translators only have to translate the phrase one time - saving you time and money! > 📘 Bonus: Set it and forget it! > > After you've defined variable(s) in a dynamic phrase, any new phrases that are found that match the pattern in that phrase will be ignored, and won't be brought in as a new phrase! View the tutorial video, or follow the instructions below to define variables in your dynamic phrases. [block:html] { "html": "" } [/block] ## Dynamic Phrase Manager The [Dynamic Phrase Manager](https://app.localizejs.com/dynamic-phrase-manager) allows you to see all of the dynamic phrases in your project. [block:image] { "images": [ { "image": [ "https://files.readme.io/a84fe4c48c11a0b6da6394346af7f21f623864c9ffa10ffbb3c7534da315d2db-Dynamic_Phrase_Mgr_v3.png", "", "" ], "align": "center", "border": true } ] } [/block] - Click the trash can to delete the phrase. - Click the edit icon to make changes to the dynamic phrase. - Click **View** to see the phrase in your dashboard. - You can also search for a dynamic phrase using the search bar. ### Importing Dynamic Phrases #### Importing from Other Projects You can import dynamic phrases from other projects in your dashboard. This is handy when you have similar content across projects and want to use the same dynamic phrases. 1. Click the **Import** button in the **Dynamic Phrase Manager** to import dynamic phrases from other projects in your dashboard. 2. Select the project from where you'd like to import the dynamic phrases. 1. Check the box to confirm that you understand that existing phrases and translations will be deleted. 2. Click **Next** to continue. [block:image]{"images":[{"image":["https://files.readme.io/4d88bdd51eed58e7d5273542128cfb0589bf08ffdce2baaea623ca9202d629e1-Import_-_Select_Project.png","",""],"align":"center","sizing":"80% ","border":true}]}[/block] 3. Select the phrases that you'd like to import, then click **Import**. [block:image]{"images":[{"image":["https://files.readme.io/81662fa1f49c703ffa6c3f782bae0b13a0f1256289db3f505731ac76b2658655-Import_-_Select_Phrases.png","",""],"align":"center","sizing":"80% ","border":true}]}[/block] 4. You'll see a toast message stating that the phrases will start being imported. Depending on how many there are, it may take a few minutes. 5. After importing dynamic phrases from another project, continue with the **[Reviewing Imported Dynamic Phrases](https://help.localizejs.com/docs/dynamic-variables#reviewing-imported-dynamic-phrases)** process below. #### Importing from a File You can import dynamic phrases from a file using the regular [import feature](https://help.localizejs.com/docs/import-export). After importing a file with dynamic phrases, continue with the **[Reviewing Imported Dynamic Phrases](https://help.localizejs.com/docs/dynamic-variables#reviewing-imported-dynamic-phrases)** process below. ### Reviewing Imported Dynamic Phrases After you import dynamic phrases from another project or from a file, you'll need to review the dynamic phrases to see if there are any existing phrase matches in your dashboard. 1. After the import, you'll see a banner at the top of the phrases page as follows. [block:image]{"images":[{"image":["https://files.readme.io/c6efea1e108b3763fa90b83558736307e556f8d550fbeb90e074094a77fddacc-Imported_Dynamic_Phrases_Need_Review.jpg","",""],"align":"center","border":true}]}[/block] 2. Select the **Click here** link to review the imported dynamic phrases. 3. You'll be presented with a pop-up to review each newly imported dynamic phrase. [block:image]{"images":[{"image":["https://files.readme.io/d303ecf25608ace9735754fe2191dd2ad6273dd16ba7863fbbf840df8ce1e60d-Imported_Dynamic_Phrases-Mark_Reviewed.jpg","",""],"align":"center","border":true}]}[/block] 4. Click the **View** button to see any matching phrases. 5. If they all match, click the **Mark reviewed** link. 6. A **Confirm review** panel will be added below. [block:image]{"images":[{"image":["https://files.readme.io/bb04c10f535ee71ffe25f55f9eaf4e868d9dec01a3cf432018159d8ff8947328-Imported_Dynamic_Phrases-Confirm_Reviewed.jpg","",""],"align":"center","border":true}]}[/block] 7. Click the checkbox to confirm that you understand that existing phrases and translations will be deleted. 8. Finally, click the **Mark reviewed** button to delete the existing phrases and keep only the new dynamic phrase. ## Identifying Dynamic Phrases The first step is to identify phrases in your project that contain mostly the same content but with perhaps 1 or 2 pieces of dynamic data. While looking through new phrases in your Pending bin, look for patterns. [block:image] { "images": [ { "image": [ "https://files.readme.io/1a7e832-Define_variables_link.png", "Define variables link.png", "" ], "align": "center", "border": true } ] } [/block] Once you've identified a group of similar phrases, click on the **Define variables** link below the phrase. > 📘 Suggested Dynamic Phrases > > As part of our **AI Agent bundle**, Localize offers the **Suggested Dynamic Phrases** feature. This will search for patterns in your phrases and will suggest dynamic phrases you can use. [Read more here.](https://help.localizejs.com/docs/dynamic-variables#suggested-dynamic-phrases) ### 1. Define variables The first step is to define your variables. #### a. Highlight the dynamic content Follow the on-screen instructions to highlight the dynamic content in the phrase. #### b. Name the variable Next, give the variable a name in the **Pending variables** panel. > 📘 Use Unique Variable Names > > If you are creating more than 1 variable in a single phrase, you must give the variables unique names. Otherwise, there may be problems when placing the variables in the translation. #### c. Advanced Options It is highly recommended for you to select any of the **Advanced Options** that are available so that you may better specify the type of variable you are defining. This will also help in clearly defining the variable part of the phrase so you don't capture other similar phrases that should _not_ be captured. #### d. Select Criteria Select the appropriate criteria from the list: - Custom Regex ([see details below](doc:dynamic-variables#custom-regex)) - Alphabetical Only - Supports only alphabet characters (A–Z, a–z), with no punctuation. - Numerical Only - Supports digits only (0–9), with no punctuation. - Numerical with Formatting - Supports numbers that include commas or periods. - Alphanumeric Only - Supports both letters and numbers (A–Z, a–z, 0–9), with no punctuation. #### e. Select Character Limit Qualifier If you selected anything other than **Custom Regex** in the previous step, you'll need to set the character limit qualifier from one of the following: - Is at least - Is at most - Is exactly #### f. Enter the Character Limit Next, enter the specific limit for the number of characters. #### g. Click **Save** Your new variable is saved, and the dynamic content in your phrase is replaced with the variable name. #### h. Repeat for other dynamic content You can repeat the process for other dynamic content in your phrase as needed. Once done, click the **Continue** button. ### 2. Review matching phrases #### a. Review phrases Matching phrases will be displayed, allowing you to see which phrases will be merged into one phrase. > 📘 All Bins are Searched > > Localize will search for matching phrases in **all** of your phrase bins. So while you may have spotted 4 in your Pending bin, there may be others in your Published or Deprecated bins. > > Localize will find all of them, and merge them all into one phrase. #### b. Click **I Understand** When ready, click the **I Understand** button. #### c. Click **Continue** Next, click the **Continue** button. ### 3. Confirm changes Review the changes that will be made. When you click the **Confirm Changes** button, your phrases will be merged into one new phrase. and you'll be returned to the Published phrases bin. > ❗️ Phrases will be deleted > > You should verify that you want the phrases to be merged, since the merging process completely deletes the duplicate phrases from your Project. > ❗️ Translations will be deleted > > When the phrases are merged, ALL translations will be deleted for the phrases, even for the phrase that remains with the variable in it. > If you need to, first save the translation somewhere outside of the Localize dashboard. After adding a variable to a phrase and adding a new translation that encompasses the variable, you'll clearly see the variable in the source phrase when you click on the variable in the translation. This will help your translators to better identify the variables in your phrases. [block:image] { "images": [ { "image": [ "https://files.readme.io/7e941f3-Highlighted_variable.jpg", "", "" ], "align": "center", "border": true } ] } [/block] > 👍 Example Use Cases: Advanced Options > > - **1st or last word in the phrase** > - Using the **Advanced Options** is especially useful when your variable is the first or last word in the phrase. > - In these cases you will want to specify the type and/or the length of the variable that you want to replace in the phrase. > - This will ensure that only the appropriate phrases will match the criteria. In the following video, we use the **Advanced Options** to limit the variable to "Numerical Only" with at most 2 digits. [block:html] { "html": "" } [/block] > 📘 Easily Find Phrases with Variables > > When a variable is defined in a phrase, Localize will add the `lz-dynamic-phrase` system label to the phrase, making it very easy to find all phrases with variables by using the [labels filter](https://help.localizejs.com/docs/searching-for-content#filter-by-labels). ### Custom Regex When using the **Advanced Options** you can select **Custom Regex** as your Criteria, and then you can enter your own custom **Regular Expression** (regex) (note the exceptions below). This gives you incredible flexibility for defining exactly what you don't want to translate in any particular phrase. For examples of custom Regular Expressions that you might want to use, and for more instructions, see the [Regular Expressions doc](https://developers.localizejs.com/docs/regular-expressions) in our Developer Docs. **NOTE 1:** You should NOT include the `^` symbol to denote the "start of a phrase", and you shouldn't use the `$` to denote the "end of the phrase". These are added for you automatically, and if you include them then your regex will fail. **NOTE 2:** You cannot add a **capture group** by using parenthesis, due to the nature of how the regex is built behind-the-scenes. > 👍 Example Use Case: Advanced Options: Regex: Percentages > > **Creating a variable for a percentage value:** > > - If your phrase is similar to this: > - "2.75% discount" > - "1.82% discount" > > 1. Select the numerical part of the phrase without the percent sign (e.g. 2.75, 1.82) > 2. Name the variable: **discount-amount** > 3. Select **Advanced Options** > 4. Add the custom regex: **\\d{1,2}\.\\d{2}** > 5. Continue on to save your new phrase. > > - This results in the phrase: **{{discount-amount}}% discount** In the following video, we define 3 variables using Regular Expressions by selecting the **Custom Regex** option in the Advanced section. [block:html] { "html": "" } [/block] ## Suggested Dynamic Phrases As part of our **AI Agent bundle**, Localize offers the **Suggested Dynamic Phrases** feature. This will automatically search for patterns in your phrases and will suggest dynamic phrases you can add. When new dynamic phrase candidates are found, a prompt will be shown on the [Manage Phrases](https://app.localizejs.com/phrases) page. [block:image] { "images": [ { "image": [ "https://files.readme.io/1ac7b79c2d90d4298a3ce2b3754e19874b50452eb8d5d1baf5b91810964f1988-Suggested_Dynamic_Phrase_on_the_Manage_Phrases_pg.png", "", "" ], "align": "center", "border": true } ] } [/block] A similar prompt will be shown on the [Dynamic Phrase Manager](https://app.localizejs.com/dynamic-phrase-manager) page, and on the [Project Overview](https://app.localizejs.com/project) page in the Phrases Overview section. [block:image] { "images": [ { "image": [ "https://files.readme.io/fdfcef7764ae1c4c8b70f4bb191998036b1adb99a7fd4fe79a4bc425f1ced727-Suggested_Dynamic_Phrase_in_the_Manager.png", "", "" ], "align": "center", "border": true } ] } [/block] 1. Click the **View** button to view the list of defined variable phrase candidates. 2. The [Defined Variable Suggestions](https://app.localizestaging.com/phrases/defined-variable-suggestions) page will be displayed. [block:image]{"images":[{"image":["https://files.readme.io/3362e4eead9d0a11a62b3f429f5410040890da749fa55d2c0a5dd0d4531fc9ef-Suggested_Dynamic_Phrases_Page.png","",""],"align":"center"}]}[/block] 3. Here you can approve, decline, or edit each suggested dynamic phrase. 4. Follow the screen prompts to edit a suggested dynamic phrase.

Sunbelt Computer Software

PL/B Language Development and Support