Salesforce

Customizing the Preference Center Template

« Go Back
Information
Customizing the Preference Center Template
UUID-42966d0e-6c85-aeee-88fd-b568ef4d3101
Article Content

You can customize the layout, styling, content, and cookie category configuration of your preference center. This allows you to create a look and feel that matches your organization's branding style.

Tip

When implementing your Preference Center, you can define language codes using underscores or hyphens.

Example: en-US or en_US.

What is a Preference Center?

A Cookie Consent Preference Center is a modal that allows users to configure cookie consent preferences. Typically, there is a link to access the Preference Center on the site as well as the cookie Banner, if one is available.

To customize a Preference Center template

Preference Centers can be customized and created in two ways. This article creating and customizing your preference center through the Templates section of the Cookie Consent application. To learn how to configure a Preference Center when scanning your domain, see Scanning a Website.

  1. On the Cookie Consent menu, select Templates. The Templates list screen appears.

  2. Select the Template you want to edit. The Template Details screen appears.

  3. Go to the Preference Center tab. Configurable elements (left) and a live preview of your Preference Center (right) display.

    Note

    Custom CSS configurations do not display in the preview.

  4. Complete the fields for Layout, Styling , Content, and Advanced Configuration.

  5. Click the Save button for each section you configure.

  6. Click the Save Template button.

Preference Center Configuration Options

Layout

This section allows you to select how the Preference Center is positioned on your website.

pc_layout.png

Field

Description

Tab

Select to display a centered, tabbed layout.

Center

Select to display a centered layout.

Panel

Select to display a left- or right-aligned layout.

Choose a Position

Select a position to configure configure the alignment of the Preference Center.

Styling 

This section allows you to customize colors for buttons, text, and the background of the Preference Center, in addition to other styling options. You can also add a custom logo.

Note

The recommended color contrast ratio is 4.5:1 for WCAG compliance. You will see a warning in the tool if the contrast ratio is below the recommended guidelines.

pref_center_styling.png

Field

Description

Override Banner Styling

Enable this setting if you want the Preference Center to be branded differently than the banner. Styling fields will appear after the setting is enabled.

Note

This setting is disabled by default and the Banner styling settings carry over to the Preference Center. To add a logo to your Preference Center, enable Override Banner Styling.

Show Object to Legitimate Interest as a button (IAB templates only)

Enable this setting to display an Object to Legitimate Interests button under the descriptions of applicable purposes.

When disabled, a setting for Legitimate Interest will be available next to the Consent setting for each purpose.

Note

Only available when you have the Allow Legitimate Interest setting enabled in the Advanced Configuration section.

Button Color

Select the color of buttons in the Preference Center.

Continue Without Accepting Link Color

Select the color for the Continue Without Accepting link text.

Button Text Color

Select the color for the text displayed on buttons.

Text Color

Select the color for the text in the Preference Center.

Background Color

Select the color for the background of the Preference Center.

Link Text Color

Select the color for the Link text

Accordion Background Color

Select the color for the background of the cookie category descriptions accordion.

Note

Applicable when you select > or +/- as the accordion type.

Focus Border Color

Select the color for the border of an in-focus element.

Legitimate Interest Button Background (IAB templates only)

Select the color for the background of the Object to Legitimate Interests button.

Note

Only available if the Show Object to Legitimate Interest as a button setting is enabled.

Legitimate Interest Button Text (IAB templates only)

Select the color for text displayed on the Object to Legitimate Interests button.

Note

Only available if the Show Object to Legitimate Interest as a button setting is enabled.

Accordion Type

Select the accordion style or remove the accordion.

Note

These three options determine how the cookie category descriptions display.

Your Logo

Click the Upload button to select a logo image to display on the Preference Center.

Click the Reset to default logo button to reset the logo to the default.

Tip

The optimum size for a logo in the Preference Center:

Height: 50px; Width: 140px.

Supported file formats are PNG, JPG, and JPEG with a maximum size of 2MB.

Company Logo Screen Reader Value (aria-label)

Enter screen reader text for the company logo.

Button Logo

Click the Upload button to select a logo image to display for the Persistent Cookie Settings hover button.

Click the Revert to Default button to reset the logo to the default.

Note

This option is available only if you enable the Enable persistent Cookie Settings hover button setting in the Button Set section.

Custom CSS

Enter custom CSS to further style the preference center to match your organization's branding needs.

Click the Apply Custom CSS button to display custom CSS in your template preview.

Note

Because there are regular updates to the Cookie Consent application, elements IDs used for CSS can change. OneTrust recommends testing custom CSS added in your template on a staging site before publishing a production CDN script.

To test custom CSS, add CSS to your template, publish the CDN script and place the script on a website. For more information, see Publishing and Implementing Cookie Consent Scripts.

Content

This section allows you to configure text for various fields on the Preference Center, including buttons and links.

Title & Description
PCTitle.png

Field

Description

Title

Enter the text for the title of the Preference Center.

Preference Center Screen Reader Value (Region Landmark)

Enter the screen reader value for the Preference Center title.

Description (non-IAB templates only)

Enter a description to be displayed in the Preference Center.

Note

To add HTML to this section, disable HTML sanitization. For more information, see Disabling HTML Sanitization.

IAB Enforced Description (IAB templates only)

This section allows you to select different types of IAB descriptions.

Important

These descriptions are enforced by IAB and cannot be edited. To add custom text to an IAB enforced description, please contact OneTrust Support or your account representative.

pc_iab_enforced_description.png

Field

Description

Select a Description

Select an IAB description.

IAB Enforced Description

The IAB-source description populates this field.

Cookie Policy Link
pc_cpolicy_link.png

Field

Description

Cookie Policy Link

Enter text to display for the Cookie Policy link at the end of your Preference Center description.

Cookie Policy URL

Enter a URL for the Cookie Policy.

Screen Reader Value (aria-label)

Enter a screen reader value for the Cookie Policy link.

Note

When configured for a CTV Preference Center, the Cookie Policy Link will display as a QR code on the Preference Center and Vendor Details tabs.

ctv_QR_PC.png

For more information, see Customizing the CTV Preference Center Template.

Imprint Link
banner_imprint.png

Field

Description

Show Imprint Link

Enable to display an imprint link on the banner.

Note

This link is optional and can be used alongside the Cookie Policy link.

Imprint Link URL

Enter a URL for the link.

Imprint Link Screen Reader Value (aria-label)

Enter a value for the imprint link aria label.

Vendor List Link
pc_vl_link.png

Field

Description

Vendor List Link

Enter a name for the link to the unfiltered Vendor List.

Vendor List Link Screen Reader Value (aria-label)

Enter a screen reader value for the Vendor List link.

Categories & Purposes List
pc_candp_list.png

Field

Description

Title

Enter a title for the Categories and Purposes list.

Show Always Active Label

Enable this setting to display the Always Active label. This label displays for the categories (and/or IAB purposes) configured with a notice-only consent model, such as Strictly Necessary.

Always Active Label

Enter text for when a category or purpose is always active.

Description Details (IAB templates only)

Select Legal Text or User Friendly Text.

Link To Full Legal Text (IAB templates only)

Enter text for the link to full legal text if User Friendly Text is selected for the Description Details field.

Links Position (IAB templates only)

Select Before Description Details or After Description Details.

Cookie List Link

Enter text for the Cookie List link.

Vendors List Link

Enter text for the Vendors List link.

Button Set
pc_button_set.png

Field

Description

Allow All Button

Text displayed on the Allow All button.

Show Reject All Button

Enable to display a Reject All button.

Reject All Button

Text displayed on the Reject All button.

For IAB templates only, when the Show Reject All Button setting is enabled, you can configure how the button interacts with Legitimate Interest.

reject_all_LI.png

Note

This feature is currently under preview. If your organization would like to enable the feature, please contact OneTrust Support.

Confirm Button

Enter text for the Confirm Choices button.

Show Close Button

Enable to show the Close button. This allows the user to exit the Preference Center without confirming choices.

You can select a traditional close button (X) or a Continue Without Accepting link depending on your business needs and compliance requirements.

Close Button Screen Reader Value (aria-label)

If Close button is selected, enter screen reader text for the Close button.

Continue Without Accepting Link

If Continue Without Accepting Link is selected, enter text for the Continue Without Accepting link.

Note

This option leaves the consent “as-is” based on the default consent model configured in the geolocation rules.

Object to Legitimate Interests (IAB templates only)

Enter text to show on the Object to Legitimate Interests button.

Note

Only applicable if the Show Object to Legitimate Interest as a button setting is enabled.

Remove Objection (IAB templates only)

Enter text to display for the Remove Objection link.

Note

Only applicable if the Show Object to Legitimate Interest as a button setting is enabled.

Objection Applied (IAB templates only)

Enter text to display when an objection to Legitimate Interests is applied.

Enable persistent Cookie Settings hover button

Enable to display a button in the bottom left of your website to resurface the Preference Center.

To change the position or location of the persistent Cookie Settings button using CSS, see Updating to the new Preference Center template.

Enable dynamic rendering for persistent Cookie Settings button (IAB templates only)

When this setting is enabled, OneTrust removes the persistent Cookie Settings hover button if other links to access the Preference Center are detected on the page.

For IAB templates, the persistent Cookie Settings hover button is automatically enabled to allows users to easily access the Preference Center to update their consent preferences.

Vendor List
Non-IAB Templates
pc_vl_normal_1.png
pc_vl_normal_2.png
pc_vl_iab_5.png

Field

Description

Allow All Consent Label

Enter text to display for Allow All Consent.

Back Button Screen Reader Value (aria-label)

Enter screen reader text for the Back button.

Show General Vendors

Enable this setting to display your configured General Vendors.

For more information, see Adding General Vendors to Vendor Lists.

You can configure the following fields if this setting is enabled:

View Vendor List Label

Enter text to display for the Vendor List button.

View Vendor List Screen Reader Value (aria-label)

Enter screen reader text for the View Vendor List button.

View Privacy Policy

Enter text to display for the View Privacy Policy link.

Vendor Level Opt-Out

Enable this setting to enable users to individually allow or reject vendors based on their preferences

Note

If a cookie within the vendor belongs to the Strictly Necessary or Always Active category, the vendor level opt-out option will not be available to the user.

Show Cookies List

Enable to show the Cookies List within the Vendor List and choose the cookie properties to display.

You can configure the following fields if this setting is enabled:

Cookie List Title

Enter text to display for the Cookie List title.

Vendor List Title

Enter text to display for the Vendor List title.

Cookie List Filter Screen Reader Value (aria-label)

Enter screen reader text for the Cookie List filter.

First-Party Cookies

Enter text to display that identifies first-party cookies.

Show Host

Select to display a cookie's host.

Show Duration

Select to display a cookie's duration.

Show Type

Select to display a cookie's type.

Show Category

Select to display a cookie's category.

Show Description

Select to display a cookie's description.

Link to Cookiepedia

Select to display a link to Cookiepedia.

Name

Enter text to display for the cookie name.

Duration Label

If Show Duration is selected, enter text for the Duration label.

Type Label

If Show Type is selected, enter text for the Type label.

Category Label

If Show Category is selected, enter text for the Category label.

Description Label

If Show Description is selected, enter text for the Description label.

Host Label

If Show Host is selected, enter text for the Host label.

First Party

Enter text for the First Party label.

Third Party

Enter text for the Third Party label.

IAB Templates
pc_vl_iab_1.png
pc_vl_iab_2.png
pc_vl_iab_3.png
pc_vl_iab_4.png
pc_vl_iab_5.png

Field

Description

Title

Enter text to display for the Vendor List title.

Description

Enter text to display for the Vendor List description.

View Privacy Policy

Enter text to display for the View Privacy Policy link.

Allow All Consent Label

Enter text to display for Allow All Consent.

Back Button Screen Reader Value (aria-label)

Enter screen reader text for the Back button.

IAB Vendors List Link

Enter text to display for the link to the IAB Vendor List.

View IAB Vendor List Screen Reader Value

Enter screen reader text for the IAB Vendor List.

IAB Vendor Label

Enter text to display for the IAB Vendor label.

Max Duration Label

Enter text to display for the Max Duration label.

Non-cookie Usage Description

Enter text to display for the Non-cookie Usage Description.

Device Storage Disclosure Label

Enter text to display for the Device Storage Disclosure label.

Identifier Label

Enter text to display for the Identifier label.

Type Label

Enter text to display for the Type label.

Purposes

Enter text to display for the Purposes label.

Domain Label

Enter text to display for the Domain label.

Domains Used

Enter text to display for the Domains Used label.

Use

Enter text to display for the Use label.

Use Google’s Additional Vendors

Enable this setting to leverage Google's Additional Vendors. Learn more here.

Field

Description

Google Vendors Label

Enter text to display for the Google Vendors label.

Show General Vendors

Enable this setting to display your configured General Vendors.

For more information, see Adding General Vendors to Vendor Lists.

You can configure the following fields if this setting is enabled:

View Vendor List Label

Enter text to display for the Vendor List button.

View Vendor List Screen Reader Value (aria-label)

Enter screen reader text for the View Vendor List button.

View Privacy Policy

Enter text to display for the View Privacy Policy link.

Vendor Level Opt-Out

Enable this setting to enable users to individually allow or reject vendors based on their preferences

Note

If a cookie within the vendor belongs to the Strictly Necessary or Always Active category, the vendor level opt-out option will not be available to the user.

Show Cookies List

Enable to show the Cookies List within the Vendor List and choose the cookie properties to display.

You can configure the following fields if this setting is enabled:

Cookie List Title

Enter text to display for the Cookie List title.

Vendor List Title

Enter text to display for the Vendor List title.

Cookie List Filter Screen Reader Value (aria-label)

Enter screen reader text for the Cookie List filter.

First-Party Cookies

Enter text to identify first-party cookies.

Show Host

Select to display a cookie's host.

Show Duration

Select to display a cookie's duration.

Show Type

Select to display a cookie's type.

Show Category

Select to display a cookie's category.

Show Description

Select to display a cookie's description.

Link to Cookiepedia

Select to display a link to Cookiepedia.

Name

Enter text to display for the cookie name.

Duration Label

If Show Duration is selected, enter text for the Duration label.

Type Label

If Show Type is selected, enter text for the Type label.

Category Label

If Show Category is selected, enter text for the Category label.

Description Label

If Show Description is selected, enter text for the Description label.

Host Label

If Show Host is selected, enter text for the Host label.

First Party

Enter text for the First Party label.

Third Party

Enter text for the Third Party label.

Filter
pc_filter.png

Field

Description

Apply Filter

Enter text for the Apply Filter button.

Cancel Filter

Enter text for the Cancel Filter button.

Clear Filter

Enter text for the Clear Filter button.

Search Vendor List

Enter text to display in the Search field on the Vendor List.

Search Cookie List

Enter text to display in the Search field on the Cookie List.

Host Not Found Label

Enter text for the Host Not Found label.

Vendors Not Found Label

Enter text for the Vendors Not Found label.

Screen Reader Announcement for Apply Action

Enter screen reader text to announce an applied action.

Screen Reader Announcement for Filter Clear Action

Enter screen reader text to announce that filter are cleared.

User ID

Note

You must enable the Capture Records of Consent setting in the template's geolocation rule in order for these fields to populate. For more info, see Configuring Geolocation Rules.

pc_user_id.png

Field

Description

Show User ID

Enable to display a user ID associated with a user on the Preference Center.

Title

Enter a title for the user ID.

Show Description

Enable to display a description of the user ID.

Description

Enter a description.

Enable Timestamp

Enable to display a timestamp of the user's most recent consent configuration (UTC).

If no previous interactions exist, this will display a timestamp for the first time users make a selection on the Banner or Preference Center.

Timestamp Title

Enter a title for the timestamp.

Not Yet Consented Text

Enter text to display before consent is granted.

Show Divider Bar (mobile Preference Centers only)

Enable to show a divider bar.

Opt Out Signal

Note

This notification is only available in the Preference Center for scripts on OneTrust 202211.1.0 or later.

opt_out_notif.png

Field

Description

Enable Opt-Out Signal Notification

Enable the setting to display a notification on cookie banners and preference centers that the opt-out preference signal has been honored.

The opt out notification displays after being enabled in the template if any of these three conditions are met:

  • GPC is enabled in a user's browser

  • GPC is configured in your geolocation rules. For more information, see Configuring Geolocation Rules.

  • A user has explicitly opted out of any cookie categories in the Banner or Preference Center

Notification

Enter the notification text to display to your end users.

Advanced Configuration

In this section you can bundle cookie categories and IAB Purposes (when applicable) to associate related categories to each other. For example, for a CCPA, you can bundle any categories that use personal data.

A Bundle Group will be given a unique category ID within the OneTrust datalayer variable, OnetrustActiveGroups. For reference, the ID could display as SPD_BG. When a user opts into the bundle group, the ID for the bundle group and IDs for categories within the bundle group will populate in OnetrustActiveGroups. When a user opts out, the bundle group ID as and IDs for the categories grouped within it will not populate in the variable.

Bundle group IDs may change when a new script version is released. OneTrust does not recommend using bundle group IDs when configuring cookie blocking. OneTrust recommend using a cookie category ID for one of the categories bundled within a group when configuring blocking for bundle groups, similar to how you would configure blocking if you were not using a bundle group. If you do choose to configure blocking using a bundle group ID, you must check if the bundle group ID has changed with a new release and update your implementation accordingly.

Field

Description

Group Categories

Note

Custom Bundle Groups generate new IDs when new template versions are created. We recommend using category IDs for all triggering to tags/scripts/SDKs. If you do choose to trigger off of bundle group IDs, you will need to update your implementation when a new template version is generated.

To create a Bundle Group
  1. Click the Group Categories button to create a new group.

  2. Enter a group name and a description (if desired).

  3. In the Select Subgroups field, select the cookie categories you would like to be grouped in the bundle group header.

  4. Click the Create button.

Once you have created the group, you will be able to update the settings for the group. To access the settings, click the Context Menu icon context_menu_icon_v2.png on the side of the group and select Settings. You can also use existing categories as group header and add existing or new categories as a subgroup by clicking on the three dots at the end of a category that should be added as a subgroup and selecting the category in the parent group drop down

Settings

In the group settings, you can update the group name, group description, view the subgroups (categories) within the bundle group, and configure the following settings:

Show Subgroups - Choose to show or not show the categories in the bundle group.

Show Subgroup Descriptions - If you choose to show the subgroups, you can show or not show the descriptions.

Subgroup Opt-out - This will allow your users to choose which categories within the bundle group to opt in or opt out off. If this setting is off, users will only be able to opt in our opt out at the bundle group level.

You can ungroup categories by clicking the Context Menu icon on the side of the group and selecting Ungroup.

To disable a category
  1. Click the Context Menu icon context_menu_icon_v2.png next to a category name. The Context menu appears.

  2. Select Disable.

Create Stack (IAB templates only)

Create a Stack from Purposes and Special Features for IAB TCF 2.0

For more information, see Implementing TCF Stacks on your Website.

Allow Legitimate Interest (IAB templates only)

Allow the Legitimate Interest purpose of processing for IAB TCF 2.0.

For more information, see Implementing TCF Stacks on your Website.

To enable Legitimate Interest (IAB templates only)

  1. On the Cookie Consent menu, go to the Templates tab. The Templates screen appears.

  2. Select your IAB TCF 2.0 template. The Template Details screen appears.

  3. Go to the Preference Center tab.

  4. Expand the Advanced Configuration section.

  5. Enable the Allow Legitimate Interest setting.

    allow_li.png
  6. Publish the script for the changes to take effect.

Updating to the new Preference Center template

You can enable the New Preference Center Template Design on the Template Details screen. These new templates have been designed to provide a smoother user interface and improve WCAG compliance. These changes will not take effect until the domain is published.

Note

Changes to the Preference Center CSS code mean that pages with custom CSS code may not function as expected. The Preference Center template can be reverted if problems occur. The changes are described in the View CSS Changes link.

new_pc_design.png

To manage Preference Center languages

The Language field displays all languages that are available for a template. Only languages that are enabled for the template will appear in the selection menu.

language_field_banner.png

You can add additional languages for the Preference Center and select from the Advanced Languages section to cover additional language HTML code options that may be used on your website. For more information on how OneTrust language detection can work on your website, see the Enable Language Detection on Scripts section in Publishing and Implementing Cookie Consent Scripts.

Note

Only out-of-the-box OneTrust Preference Center text is automatically translated for applicable languages. Any custom text changes made to a template are not automatically translated to other languages. For these changes to translate, you must provide your own translations in the template.

Tip

In your Preference Center script, you can define language codes using underscores or hyphens.

Example: en-US or en_US.

  1. On the Cookie Consent menu, select Templates. The Templates screen appears.

  2. Click on the name of the template. The Template Details screen appears.

  3. Click the Manage Languages button. The Manage Languages modal appears.

    banner_languages.png
  4. Select the checkboxes for the languages you want to enable. You can select a new default language by selecting the check box in the Default column.

    Note

    If you want to select languages based on locality, enable the Show Advanced Languages setting.

  5. Click the Save button.

 
Article Visibility
62,753
Translation
English
Checked

Powered by