Merge pull request #8433 from braze-inc/bd-3669

BD-3669 Update custom attribute locales

_docs/_user_guide/administrative/app_settings/multi_language_settings.md

@@ -17,16 +17,41 @@ To edit and manage multi-language support, you must have the "Manage Multi-Langu
 ## Add a locale
 
 1. Go to **Settings** > **Multi-Language Support** under **Workspace Settings**.
-2. Select **Add locale**.
+2. Select **Add locale**, and then select **Default locale** or **Custom Attributes**.<br><br>![The "Add locale" dropdown with options to select the default locale or custom attributes.][1]{: style="max-width:40%;"}
 3. Enter a name for the locale.
-4. For the **User attributes**, select the language to be added using the **Language** dropdown.
-5. (optional) Select the country to be associated with the language.
-6. Select **Add locale**. 
+4. Select the respective user attributes for your chosen locale option.
 
-![An example of French added as a locale for users whose country is Canada.][2]{: style="max-width:80%;"}
+{% tabs %}
+{% tab Default locale %}
+
+For **Default locale**, use the dropdowns to select the language to be added and, optionally, the country to be associated with the language.<br><br>![A window called "Add locale - Default Language and Country" to specify the language and country.]({% image_buster /assets/img/multi-language_support/default_option.png %}){: style="max-width:80%;"}
+
+{% endtab %}
+{% tab Custom attributes %}
+
+For **Custom Attributes**, use the dropdown to select the associated custom attribute and in the text field, enter the value.<br><br>![A window called "Add locale - Custom Attributes" to specify the custom attribute and value.]({% image_buster /assets/img/multi-language_support/custom_attributes_option.png %}){: style="max-width:80%;"}
+
+{% endtab %}
+{% endtabs %}
+
+{: start="5"}
+5. Select **Add locale**. 
 
 For steps to use these locales in your email campaigns and Canvas, refer to [Using locales]({{site.baseurl}}/user_guide/message_building_by_channel/email/using_locales/).
 
+## Considerations
+
+When setting up a locale, you can either select languages from the default user attributes or custom attributes. You can't select from both.
+
+You can select up to two custom attributes in a single locale, or up to two default user attribute languages. In both cases, the second attribute is optional.
+
+### Support and prioritization
+
+- Users that match a custom attribute locale get prioritized before users that match a default user attribute.
+- Custom attribute support is limited to string types and the `equals` comparison key.
+- If a custom attribute gets deleted by Support or the type gets changed, the user can no longer fall into that locale and will either go down the priority list of locales they fall under or receive default marketing translations.
+- If a locale is invalid (the custom attribute changed or is deleted), the error will appear on the **Multi-Language Support** page.
+
 ## Frequently asked questions
 
 #### How many locales can I add?
@@ -38,7 +63,4 @@ Translation files are stored at a campaign level, meaning each message variant m
 #### Does the locale name have to follow a specific pattern or format?
 No. You can use your preferred naming convention. The locale name is used when selecting the locale in the editor and will be in the headings of the file you download with translation IDs.
 
-#### Can I use custom attributes to define a locale?
-Not currently. Contact your account manager or leave [product feedback]({{site.baseurl}}/user_guide/administrative/access_braze/portal/) with more details on how you would define locales.
-
-[2]: {% image_buster /assets/img/multi-language_support/add_locale.png %}
+[1]: {% image_buster /assets/img/multi-language_support/add_locale_options.png %}