Preferences message builder component

Preferences messages allow your organization to collect and manage an end-user's marketing preferences and/or acceptance of legal documents. In this article, we will cover the key aspects of the Category component in the Preferences message builder which will be used to surface the marketing and/or legal preference categories that you have set up elsewhere in your configuration.

• Category
• Content
• Language translation for Category component
• Selection controls

From the Preferences message builder, add the Category component to you message by clicking the + icon in the Toolbar pane.

Select the Category component from the subsequent modal.

The Category component will be added to your Preferences message. Click the recently added component and navigate to the Settings pane to configure the component. 

---

Category

The Category accordion enables your organization to select which category you wish to pull into the message from the associated Preferences configuration. Use the provided buttons to select whether the component should be utilizing a marketing preference or legal preference category. 

Once a selection is made, utilize the dropdown menu to select a specific category.

Field	Description
Marketing	Enables you to add a marketing preference category to your message. Each Category component in your message can only have one marketing preference category associated with it.
Legal	Enables you to add a legal preference category to your message. The Category component can have multiple legal preference categories associated with it (i.e. end-users can accept/reject/be notified of multiple legal transactions with a single component.     Note: If multiple legal preference categories are added to a single Category component then the content for the component (Category Name and Category Description) will need to be overwritten within the message builder.
Hide category component	When checked, will hide the component from being seen by the end-user.

Information and content for your selected category will populate in the Category component for the message as it is setup in your Preferences configuration.

---

Content

The Content accordion enables you to overwrite and provide translations for the marketing preference or legal preference category name and description. 

	Description
Default	The category name, category description, and any translations are pulled into the message from the Preferences configuration associated with the property. The Preferences configuration associated with the property is the source of the content and any updates should be made in the configuration.
Message overwrite	Edit and provide translations for the category name and category description being pulled into the message from the Preferences configuration associated with the property. The edits you make in the Content accordion will overwrite the default content and be saved on a per message basis. Overwriting the category content in the message will not impact what is setup in the Preferences configuration.

---

Language translation of Category component

Managing the translations of the category content (i.e. the category name and category description) depends on whether you are relying on the default content setup in the Preferences configuration or whether this content has been overwritten in the message Content accordion.

	Translations
Default	Default translations for category name and category description are managed in the Preferences configuration. Please review the documentation below for more information: Legal preference category translations Marketing preference category translations
Message overwrite	Translations for overwritten category name and category description is edited and saved in the message builder. See below for more information.

In this section we will cover how to provide translations for overwritten category name and category description for a Content component. 

From the Home view of the message builder, navigate to the Settings panel on the right-hand side and expand the Language accordion.

Field	Description
Default Language	Defines the language that will appear by default for your end-users. That is, if the end-user's browser default language is not supported and a language translation is not provided, the end-user will see all content in your default language. Use the provided dropdown menu to select your default language for the Preferences message.
Supporting Language	Allows you to add all the languages you plan to support with your translations.   Note: The default language is also added to the Supporting Language field.
Use Browser Default	Toggle this feature ON in order to have the Preferences message dynamically surface the appropriate translations based on an end-user's default browser language.

Once your supported languages are selected, select a Category component for which you will be providing translations for overwritten content. Expand the Content accordion on the right-hand pane. 

Navigate to the Language field for either Category Name or Category Description and select a supported language that you previously added. 

Input the translation for both Category Name and Category Description. 

Repeat as necessary for other support languages.

---

Selection controls

The selection controls accordion of the Category component allows you to configure the selection mechanism that the end-user will use to consent or reject the marketing preference or legal preference category. 

Field	Description
Type	Enables you to change the selection mechanism that the end-user would use to consent or reject the marketing preference or legal preference category.
Control Position	Decides whether the selection mechanism is placed to the right or left of the marketing preference or legal preference category.