Skip to main content

Config Editor

The Config Editor provides direct access to your site's JSON configuration for advanced customization.

Accessing the editor​

  1. Select your site from the site switcher
  2. Navigate to Config Editor in the sidebar
  3. The current configuration loads in the editor

Configuration structure​

{
  "siteKey": "my-site-prod",
  "version": 2,
  "banner": {
    "position": "bottom",
    "layout": "bar"
  },
  "categories": [
    {
      "id": "necessary",
      "label": "Necessary",
      "required": true
    },
    {
      "id": "analytics",
      "label": "Analytics",
      "defaultState": false
    }
  ],
  "regionRules": [...],
  "theme": {...}
}

Key configuration sections​

PropertyDescription
positiontop, bottom, center
layoutbar, modal, corner
showPreferencesShow preferences button
blockingModeBlock page until consent

Categories​

Define consent categories:

{
  "id": "marketing",
  "label": "Marketing",
  "description": "Cookies for advertising and retargeting",
  "defaultState": false,
  "vendors": ["google-ads", "facebook-pixel"]
}

Region rules​

Customize behavior by region:

{
  "region": "EU",
  "defaultConsent": "opt-in",
  "showBanner": true,
  "blockingMode": true
}

Editing workflow​

  1. Edit: Make changes in the editor
  2. Validate: Click Validate to check for errors
  3. Preview: Click Preview to see changes in a sandbox
  4. Save: Click Save to publish changes

Changes take effect within 60 seconds (CDN cache TTL).

Version history​

The editor maintains a version history:

  • View previous versions in the History tab
  • Compare versions side-by-side
  • Rollback to any previous version

Schema validation​

The editor validates your configuration against the CMP schema:

  • Errors: Must be fixed before saving (red)
  • Warnings: Optional improvements (yellow)
  • Info: Best practice suggestions (blue)

Import/Export​

Export configuration​

  1. Click Export (download icon)
  2. Choose format: JSON or YAML
  3. Save to your local machine

Import configuration​

  1. Click Import (upload icon)
  2. Select a JSON or YAML file
  3. Review the diff
  4. Click Apply

Environment sync​

Copy configuration between environments:

  1. Open the source site's config
  2. Click Copy to...
  3. Select target site key
  4. Review and confirm

Next steps​