---
title: "Setup"
date: "2024-07-24T17:45:20+00:00"
summary: "Configure Web Governance Consent Manager settings for design, privacy regulations, languages, and cookie list display options."
image:
type: "page"
url: "/web-governance/setup"
id: "4231f0ec-a723-496e-81bc-fbfa56acf4dd"
---

This page explains the basic settings that can be altered for Web Governance Consent Manager.
=============================================================================================

Quick setup[​](https://developer.monsido.com/consent-manager/setup#quick-setup "Direct link to Quick setup")
------------------------------------------------------------------------------------------------------------

The minimum requirement for setup is to add this script to the pages where Web Governance Consent Manager should appear.

    window._monsidoConsentManagerConfig = {
        token: "insert-your-monsido-token-here"
    }
    

Design and appearance[​](https://developer.monsido.com/consent-manager/setup#design-and-appearance "Direct link to Design and appearance")
------------------------------------------------------------------------------------------------------------------------------------------

Using the settings on `_monsidoConsentManagerConfig` you can control the design of Web Governance Consent Manager. Find a list of all options and types in the "Settings" section in the left-side menu.

**Example**

    window._monsidoConsentManagerConfig = {
        token: "insert-your-monsido-token-here",
        privacyRegulation: ["ccpa","gdpr"],
        settings: {
            manualStartup: false,
            hideOnAccepted: false,
            perCategoryConsent: true,
            explicitRejectOption: false,
            hasOverlay: false,
        };
        i18n: {
            languages: ["en_US", "nb_NO", "de_DE", "es_ES", "da_DK"],
            language: "en_US",
        },
        theme: {
            "buttonColor":"#e2433c",
            "buttonTextColor":"#fdfede",
            iconPictureUrl: "stroopwafel",
            iconShape: "rounded_box",
            position: "bottom-center",
        },
        links: {
            cookiePolicyUrl: "https://insert-your-url-here",
            linkToCookieOverview: "https://insert-your-url-here",
            optOutUrl: "https://insert-your-url-here",
        },
        cookieOverview: {
            enable: false,
            containerSelector: "#cookie-overview-container",
            hideInPreferences: false
        }
    };
    

### Using your own button/link instead of the consent widget[​](https://developer.monsido.com/consent-manager/setup#using-your-own-buttonlink-instead-of-the-consent-widget "Direct link to Using your own button/link instead of the consent widget")

It is possible to remove the consent widget. By using the `hideOnAccepted` setting, you can set the consent widget to not appear automatically once the visitor has made a consent choice on the cookie banner.

**Example**

    window._monsidoConsentManagerConfig = {
        token: "insert-your-monsido-token-here",
        settings: {
            hideOnAccepted: true,
        }
    };
    

Instead, you can make the cookie banner show when a visitor clicks any button or link on your website. This can be achieved by executing the following script when an element with a specific class attribute is clicked by the visitor:

**Example**

    <script type="text/javascript">
      window.MonsidoCookieOnLoad = function() {
          var cookiePreferencesEl = document.querySelector(".element-class-name");
        if (cookiePreferencesEl) {
          cookiePreferencesEl.addEventListener("click", function() {
            window.monsidoConsentManager.showBanner("cookie-preferences");
          });
        }
        var mcmEl = document.querySelector('mon-cb-main');
        if (mcmEl) {
          mcmEl.classList.add('mcm-slide-up');
        }
    };
     </script>
    

You'll need to replace `.element-class-name` with the class of the button or link that you want to trigger the banner on click.

Privacy regulations[​](https://developer.monsido.com/consent-manager/setup#privacy-regulations "Direct link to Privacy regulations")
------------------------------------------------------------------------------------------------------------------------------------

Web Governance Consent Manager supports both CCPA and GDPR. You can adjust whether you want the cookie banner to adapt to one or both at the same time using the `privacyRegulation` setting.

**Example**

    window._monsidoConsentManagerConfig = {
        token: "insert-your-monsido-token-here",
        privacyRegulation: ["GDPR", "CCPA"],
    };
    

### GDPR[​](https://developer.monsido.com/consent-manager/setup#gdpr "Direct link to GDPR")

The required and unique setting for the GDPR version of the cookie banner is `perCategoryConsent`. This ensures that visitors are allowed to opt-out of specific categories of cookies on the cookie banner.

**Example**

    window._monsidoConsentManagerConfig = {
        token: "insert-your-monsido-token-here",
        settings: {
            perCategoryConsent: true
        };
    };
    

### CCPA[​](https://developer.monsido.com/consent-manager/setup#ccpa "Direct link to CCPA")

The required and unique setting for the GDPR version of the cookie banner is `optOutUrl`. This ensures that visitors can be directed to a web page on your website where they can opt-out of having their personal data sold to third parties.

**Example**

    window._monsidoConsentManagerConfig = {
        token: "insert-your-monsido-token-here",
        privacyRegulation: ["GDPR"],
        links: {
            optOutUrl: "https://insert-your-url-here",
        }
    };
    

Languages[​](https://developer.monsido.com/consent-manager/setup#languages "Direct link to Languages")
------------------------------------------------------------------------------------------------------

Web Governance Consent Manager supports English (US) and Danish. Use the `language` setting to specify language on the cookie banner. Consent Manager supports English (US), Spanish, German, Norwegian Bokmål, Dutch and Danish. Use the `languages` setting to specify languages that you want the cookie banner to show in. Use `defaultLanguage` to define a fallback language that the banner will be displayed in if a web page is in a language that is not supported.

**Example**

    window._monsidoConsentManagerConfig = {
        token: "insert-your-monsido-token-here",
        i18n: {
            languages: ["en_US", "nb_NO", "de_DE", "es_ES", "da_DK"],
            language: "en_US",
        },
    };
    

Show or hide list of cookies on cookie banner[​](https://developer.monsido.com/consent-manager/setup#show-or-hide-list-of-cookies-on-cookie-banner "Direct link to Show or hide list of cookies on cookie banner")
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

If you have selected GDPR as your privacy framework, by default all your cookies will show on the actual cookie banner. For CCPA, they will not show.

### Display list of cookies on your website[​](https://developer.monsido.com/consent-manager/setup#display-list-of-cookies-on-your-website "Direct link to Display list of cookies on your website")

You can select to have a dedicated page for the cookie list. You can use the `linkToCookieOverview` settings to do that.

    cookieOverview: {
        token: "insert-your-monsido-token-here",
        privacyRegulation: ["GDPR"],
        links: {
            linkToCookieOverview: "https://insert-your-url-here"
        }
    }