Preference center overview
Access Type: PMP Widgets - Editor
Premium Feature: Preference Management Platform
A preference center is a special type of preferences widget that is accessible via a dedicated URL (either hosted on a managed domain by Didomi or a custom domain).
Note: The directions in this article and section assume your organization is creating and configuring your preference center within the Didomi console which limits the deployment options available per widget format.
Click here to learn more about the differences between utilizing the Didomi console vs the Didomi API and its impact on deployment.
While most of the configuration of a preference center is similar to that of other preferences widgets, there are additional configurations available for preference centers. In this article, we will cover configurations that are unique to a preference center.
To start, click Preference Management on the left-hand panel and ensure the Widgets tab is selected on the subsequent page.
Navigate to a preferences widget with the format Preference center on the list and click the Edit icon inline with the preferences widget name.
Content editor
In addition to editing the content of a purpose, preference, and/or preference value option, your organization can also configure the content for the following elements specifically for a preference center:
Browser tab
Header
Footer
From the preferences widget configuration flow for a preference center, click the Content editor tab.
View the preferences widget in one of your organization's enabled languages by clicking Content edition in the right-hand panel and selecting the language from the provided drop-down menu.
Select the container for the element (e.g. browser tab, header, etc...) for which you are editing the translation.
Navigate to the element in the content edition tab and use the provided space to edit the translation and customize branding.
Didomi provides automatic translations for certain elements of the header, save card, and footer. These translations can be edited if required.
The browser tab panel allows you to manage the favicon and title of the browser tab.
Favicon
Recommended 16x16px png
Title
If a title for the translation is not provided Didomi will display the preference center's URL
The header panel allows your organization to manage the editorial and branding content for the preference center. Elements of the header include:
Display the user email address
Toggle to display/hide end-user's email address
Brand logo
Recommended 128x128px png
Preference center title
The default title for your preference center is Manage your preferences. Note: This field can not be empty.
Introduction text
Introductory text provided by your organization to the preference center
Banner image
Recommended 780x320px png
The footer panel allows you to manage the footer of your preference center. From this panel, you can modify the:
Footer icon
Thank you message
Hosting
Unlike single or multi purpose preferences widgets, a preference center is not embedded onto your organization's website(s). When your organization's preference center is published, a configuration file is created and stored in an AWS bucket. A resource with the domain used by the preference center will be created in order to serve the webpage to your end-users.
From the preferences widget configuration flow for a preference center, click the Hosting tab.
In this section, we will cover the two options your organization can use to host and serve your preference center to its end-users.
By default, when your preference center is published, a default domain is automatically generated via a Didomi managed domain. The managed domain enables your organization to custom the subdomain while utilizing the fixed domain preference-center.org.
The format of the URL assigned to a preference center utilizing a managed domain is as follows:
The subdomain is comprised of two distinct parts:
organization_id
Unique identifier for your organization's Didomi account
widget_id
Unique identifier for the preference center
Your organization can edit the default subdomain supplied to your organization's preference center by navigating to the right-hand panel and edit the provided field in the Use managed domain section.
When editing the subdomain your organization will need to adhere to the following rules:
only contains lowercase letters (26 letters of the English alphabet), numbers (0-9), hypen sign (-)
must start with a letter or number
no consecutive hyphens
entire hostname cannot exceed 255 characters
subdomain cannot exceed 63 characters
Didomi will check whether the edited subdomain is available. If so, the subdomain will only be booked when the widget is saved.
As an alternative to the default managed domain provided by Didomi, your organization can also utilize its own domain. In order to successfully utilize a custom domain to load your preference center, the domain must meet the following requirements:
must already exist
must be in Ready status
usage for domain is correctly set to Serve a hosted page (Didomi console) or
preference-center(API)not assigned another widget
Click here to review Didomi developer documentation for domains.
To utilize a custom domain to load a preference center, navigate to the right-hand panel and enable the toggle for Use custom domain. Select a custom domain from the list (if available).
If a custom domain is not available, click Add custom domain to continue.
Follow the necessary steps to create a custom domain and select it from the list when finished.
Last updated