---
title: Customize a widget
description: "New: You can now customize the display of Single Purpose Widgets directly in the Console. Choose the selection input type and adjust their appearance in the Look & Feel step. For advanced layouts or A"
---

[Skip to content](https://support.didomi.io/custom-a-widget#main-content)

- [English](https://support.didomi.io/custom-a-widget)
- [Français](https://support.didomi.io/fr/personnaliser-un-widget)

English

Show submenu for translations

[Customer portal](https://support.didomi.io/tickets-view)

![Didomi SAS](https://support.didomi.io/hs-fs/hubfs/Didomi-tail-name.png?width=182&height=34&name=Didomi-tail-name.png)

Open main navigation

Close main navigation

- - [English](https://support.didomi.io/custom-a-widget)
    - [Français](https://support.didomi.io/fr/personnaliser-un-widget)

  English
  
  Show submenu for translations
- [Customer portal](https://support.didomi.io/tickets-view)
- Go to didomi.io

 Go to didomi.io

 Our documentation has moved to docs.didomi.io. Please update any bookmarks.

- There are no suggestions because the search field is empty.

1. [Help Center](https://support.didomi.io/)
2. [Preference Management Platform](https://support.didomi.io/preference-management-platform)
3. [Widget](https://support.didomi.io/preference-management-platform#widget)

# Customize a widget

New: You can now customize the display of Single Purpose Widgets directly in the Console. Choose the selection input type and adjust their appearance in the Look & Feel step.   
For advanced layouts or API-level options, see our [Developers documentation](https://developers.didomi.io/api-and-platform/widgets/privacy-widgets/edit-a-widget/content-and-design/themes-and-shapes).

Customize a Single Purpose Widget

1. Go to the **Preference Management** tab, in the left menu.
2. Go to the **widgets** tab.
3. Create a new **Single Purpose Widget**, select the Purpose you want to be displayed.
4. Go to **Look & Feel**. The Look & Feel window is located on the right side of your screen.
5. Choose on which type of selection input your end-users express their choice in a Single Purpose Widget:

- Radio buttons (mutually exclusive options)
- Single checkbox (true/false)
- Tap to change (a sentence with an embedded CTA link)
  
  ![](https://support.didomi.io/hs-fs/hubfs/Screenshot%202025-10-07%20at%2014-37-10-png.png?width=250&height=334&name=Screenshot%202025-10-07%20at%2014-37-10-png.png)

To benefit from these new input selection options, you will need to create a new Single Purpose Widget.

Customize Multi Purpose Widgets and Preference Centers

Layout Shape

#### Customize widget shape

1. Go to the **Preference Management** tab, in the left menu.
2. Go to the **widgets** tab.
3. Choose the widget you want to customize.
4. Click on the **pen icon** on the same line as the widget you want to customize.
5. Click on **Look & Feel**. The Look & Feel window is located on the right side of your screen.
6. Go to the **Layout Shape** section.
7. Select the shape between **Smoothed**, **Rounded**, and **Squared**.

![Card content (1)-1](https://support.didomi.io/hs-fs/hubfs/Card%20content%20(1)-1.png?width=382&name=Card%20content%20(1)-1.png)

### Theme

You have the possibility to select an existing theme to quickly add style to your widget, or to create a new one by yourself.

#### Select widget theme

1. Go to the **Preference Management** tab, in the left menu.
2. Go to the **widgets** tab.
3. Choose the widget you want to edit.
4. Click on the **widget's name** or on the **pen icon,** on the same row as the widget you want to edit.
5. Click on **Look & Feel**. The Look & Feel window opens on the right side of your screen.
6. Go to the section **Layout Colors**.
7. Select the theme you want between **Default**, **Abyss**, **Lagoon**, **Ocean** and **Sunset**.

![Didomi themes](https://support.didomi.io/hubfs/Frame%20933.svg)

#### Custom widget theme

In the Preference Management Platform, you also have the possibility to customize the theme of your widget, to match your brand identity.

1. Go to the **Preference Management** tab, in the left menu.
2. Go to the **widgets** tab.
3. Choose the widget you want to customize.
4. Click on the **widget's name** or on the **pen icon,** on the same row as the widget you want to customize.
5. Click on **Look & Feel**. The Look & Feel window is located on the right side of your screen.
6. Go to the section **Customized colors**.

![customized\_colors](https://support.didomi.io/hs-fs/hubfs/customized_colors.png?width=688&name=customized_colors.png)

In this section, you can select the colors you want for your widget by yourself for these areas:

| Area | Impacted items |
| --- | --- |
| Header | Main title, description text |
| Section title | All the section titles between the cards |
| Card title | Card titles |
| Card body copy | Card body copy |
| Selection buttons | Radio buttons, checkboxes cards |
| Save button | Save button |
| Footer | Success icon, Thanks message |
| Background | Background of the widget |

The colors are in hexadecimal format, for example: **#F56B2A.**

#### To choose a color:

1. Choose a section. For example: Section title.
2. Click on the hexadecimal color code. A color picker opens.
3. Play with the pipette or your cursor to find the color that matches your expectations. You can also directly enter the hexadecimal code.

### Headless widgets

*Only Single and Multi purpose widgets can become Headless. *

Headless widgets enable you to create fully customizable widgets in terms of both design and behavior. These widgets rely on the Didomi’s widgets engine, so they feature authentication management, analytics, content rendering, purpose and preference choices, and saving upon clicking or after user confirmation.

A set of elements like events and methods are available for generating the widget and collecting end-user consent and preference choices.

To understand how to build a Headless widget, please refer to our [dedicated technical documentation.](https://developers.didomi.io/api-and-platform/widgets/privacy-widgets/headless-widgets)

- [Consent notice creation](https://support.didomi.io/consent-notice-creation#main-content)

    - [Basics](https://support.didomi.io/consent-notice-creation#basics)
    - [Consent notice per device](https://support.didomi.io/consent-notice-creation#consent-notice-per-device)
    - [Manage Vendors and Purposes](https://support.didomi.io/consent-notice-creation#manage-vendors-and-purposes)
    - [Customization](https://support.didomi.io/consent-notice-creation#customization)
    - [Multi-regulations](https://support.didomi.io/consent-notice-creation#multi-regulations)
    - [Frameworks](https://support.didomi.io/consent-notice-creation#frameworks)
    - [Integrations](https://support.didomi.io/consent-notice-creation#integrations)
    - [Console migration](https://support.didomi.io/consent-notice-creation#console-migration)
    - [IAB GPP Framework](https://support.didomi.io/consent-notice-creation#iab-gpp-framework)
    - [Accessibility](https://support.didomi.io/consent-notice-creation#accessibility)
- [Compliance report](https://support.didomi.io/compliance-report#main-content)

    - [CMP Vendor Sync](https://support.didomi.io/compliance-report#cmp-vendor-sync)
    - [Advanced Compliance Monitoring](https://support.didomi.io/compliance-report#advanced-compliance-monitoring)
- [Preference Management Platform](https://support.didomi.io/preference-management-platform#main-content)

    - [Configuration Tree](https://support.didomi.io/preference-management-platform#configuration-tree)
    - [Widget](https://support.didomi.io/preference-management-platform#widget)
    - [Deployment](https://support.didomi.io/preference-management-platform#deployment)
- [Google integrations](https://support.didomi.io/google-integrations)
- [Privacy Request](https://support.didomi.io/privacy-request#main-content)

    - [User Requests](https://support.didomi.io/privacy-request#user-requests)
    - [Widgets](https://support.didomi.io/privacy-request#widgets)
- [IAB TCF](https://support.didomi.io/iab-tcf#main-content)

    - [Google & TCF](https://support.didomi.io/iab-tcf#google-tcf)
    - [TCFv2 Presentation](https://support.didomi.io/iab-tcf#tcfv2-presentation)
    - [TCF v2.2](https://support.didomi.io/iab-tcf#tcf-v2-2)
- [Analytics](https://support.didomi.io/analytics#main-content)

    - [Consent Management Platform (CMP) Analytics](https://support.didomi.io/analytics#consent-management-platform-cmp-analytics)
    - [Preference Management Platform (PMP) Analytics](https://support.didomi.io/analytics#preference-management-platform-pmp-analytics)
    - [ACM (Advance Compliance Monitoring)](https://support.didomi.io/analytics#acm-advance-compliance-monitoring)
- [Integrations](https://support.didomi.io/integrations#main-content)

    - [AB testing](https://support.didomi.io/integrations#ab-testing)
    - [Paywalls](https://support.didomi.io/integrations#paywalls)
    - [CMS](https://support.didomi.io/integrations#cms)
    - [Generic integrations](https://support.didomi.io/integrations#generic-integrations)
    - [Marketing automation](https://support.didomi.io/integrations#marketing-automation)
    - [Customer Data Platform (CDP)](https://support.didomi.io/integrations#customer-data-platform-cdp)
    - [CRM](https://support.didomi.io/integrations#crm)
- [Lexicon](https://support.didomi.io/lexicon)
- [Legal Requirements](https://support.didomi.io/legal-requirements#main-content)

    - [Didomi SDK compliance](https://support.didomi.io/legal-requirements#didomi-sdk-compliance)
- [Privacy Center and Data Processing](https://support.didomi.io/privacy-center-and-data-processing)
- [FAQ](https://support.didomi.io/faq#main-content)

    - [CMP / Managing tags](https://support.didomi.io/faq#cmp-managing-tags)
    - [CMP / Data Privacy for publishers](https://support.didomi.io/faq#cmp-data-privacy-for-publishers)
    - [CMP / Implementing a consent notice](https://support.didomi.io/faq#cmp-implementing-a-consent-notice)
    - [Debugging](https://support.didomi.io/faq#debugging)
    - [CMP / CPRA](https://support.didomi.io/faq#cmp-cpra)
    - [CMP / Analytics](https://support.didomi.io/faq#cmp-analytics)
    - [PMP](https://support.didomi.io/faq#pmp)
    - [Share consent](https://support.didomi.io/faq#share-consent)
    - [Customization](https://support.didomi.io/faq#customization)
    - [Cookies](https://support.didomi.io/faq#cookies)
    - [IAB](https://support.didomi.io/faq#iab)
- [Versions & Proofs](https://support.didomi.io/versions-proofs)
- [Login & Security](https://support.didomi.io/login-security#main-content)

    - [SSO](https://support.didomi.io/login-security#sso)
    - [Users, Teams and Permissions](https://support.didomi.io/login-security#users-teams-and-permissions)
- [Privacy Hub widget](https://support.didomi.io/privacy-hub-widget)
- [Consent Notices (old flow)](https://support.didomi.io/consent-notices-old-flow)
- [Consent Notices (NEW FLOW)](https://support.didomi.io/consent-notices-new-flow)
- [Customer Portal - Tickets](https://support.didomi.io/customer-portal-tickets)
- [Organization settings](https://support.didomi.io/organization-settings)
- [SDK version control](https://support.didomi.io/sdk-version-control)

Didomi, verb in ancient greek (δ‌‌ιδο‌μι): consent.

Copyright © 2026, Didomi SAS

Cookies