consent-pref-center

Building a Consent Preference Center

Overview

A consent preference center is the centralized interface through which data subjects manage their consent choices across all processing purposes. Under GDPR Article 7(3), withdrawal of consent must be as easy as giving it, making a well-designed preference center critical for compliance. The IAB Europe Transparency and Consent Framework (TCF) v2.2 provides a standardized approach for advertising-related consent that integrates with this architecture.

Architecture Components

1. Data Model

The consent preference center requires four core data entities:

Consent Purpose Registry Stores all processing purposes for which consent is the lawful basis.

Consent Text Version Immutable records of consent text presented to users.

Consent Decision Records each consent decision made by a data subject.

Consent Propagation Log Tracks downstream system notifications after consent changes.

2. API Design

GET /api/v1/consent/preferences/{subject_id} Returns current consent state for all purposes for a given data subject.

Response:

{
  "subject_id": "usr_7f3a9b2e-41d8-4c76-b5e3-9a8d1c2f4e60",
  "preferences": [
    {
      "purpose_id": "pur_analytics_001",
      "purpose_name": "Service Improvement Analytics",
      "decision": "granted",
      "granted_at": "2026-01-15T10:30:00Z",
      "version_id": "ver_a1b2c3d4"
    },
    {
      "purpose_id": "pur_marketing_002",
      "purpose_name": "Product Update Emails",
      "decision": "withdrawn",
      "withdrawn_at": "2026-02-20T14:45:00Z",
      "version_id": "ver_e5f6g7h8"
    }
  ],
  "last_updated": "2026-02-20T14:45:00Z"
}

PUT /api/v1/consent/preferences/{subject_id} Updates consent for one or more purposes. Triggers downstream propagation.

Request:

{
  "decisions": [
    {
      "purpose_id": "pur_marketing_002",
      "decision": "granted",
      "mechanism": "toggle_switch"
    }
  ]
}

GET /api/v1/consent/history/{subject_id} Returns full consent history for audit purposes per Article 7(1).

GET /api/v1/consent/receipt/{decision_id} Returns a single consent receipt in Kantara Initiative Consent Receipt format.

3. TCF v2.2 Integration

The IAB Transparency and Consent Framework v2.2 (released September 2023) requires:

• TC String Generation: Encode consent signals into the IAB TC String format. The TC String is a base64url-encoded bitfield that captures consent for TCF-defined purposes (1-11) and legitimate interest assertions.
• CMP Registration: Register with the IAB Europe as a Consent Management Platform. Each registered CMP receives a unique CMP ID used in TC String generation.
• Vendor List Integration: Consume the IAB Global Vendor List (GVL) to display vendor-level consent options. The GVL is published at vendorlist.consensu.org and updated weekly.
• Purpose Mapping: Map internal CloudVault SaaS Inc. purposes to TCF v2.2 purposes:
• TCF Purpose 1 (Store and/or access information on a device) → Cookie consent
• TCF Purpose 3 (Create profiles for personalised advertising) → If applicable
• TCF Purpose 7 (Measure ad performance) → Analytics consent
• Publisher Restrictions: Configure publisher-level restrictions to limit vendors to consent-only legal basis where CloudVault SaaS Inc. policy requires it.

4. UI Component Specification

The preference center interface at CloudVault SaaS Inc. follows these design principles:

Layout:

• Accessible at Settings > Privacy > Manage Consent (maximum 2 clicks from any page)
• Also accessible via direct URL: app.cloudvault-saas.eu/settings/privacy
• Persistent "Privacy Choices" link in the page footer on every page

Per-Purpose Toggle:

• Each purpose displays: purpose name, 1-sentence description, current state (on/off toggle)
• "Learn More" expandable section with: full description, data categories, recipients, retention period
• Toggle change triggers immediate API call and visual confirmation

Consent History:

• "View History" link per purpose showing: date, action (granted/withdrawn), consent text version
• Downloadable consent receipt in JSON format (Kantara Consent Receipt specification v1.1)

Withdrawal Flow:

• Single toggle click to withdraw (matching the single click to grant during sign-up)
• Confirmation dialog: "Are you sure you want to withdraw consent for [purpose]? This will stop [specific processing]. You can re-enable this at any time."
• Post-withdrawal confirmation: "Consent withdrawn. Processing will stop within 24 hours."

Version History and Audit Trail

Every consent text change creates a new version record. The preference center always displays the current version but retains all historical versions. Audit queries can reconstruct:

• What text was shown to a specific user at a specific time
• When consent was given and withdrawn for each purpose
• Whether downstream systems were notified of consent changes
• The propagation status and timing for each consent change

Key Regulatory References

• GDPR Article 7(1) — Demonstrating consent
• GDPR Article 7(3) — Right to withdraw consent, equal ease requirement
• GDPR Article 12(1) — Transparent, intelligible, easily accessible information
• IAB TCF v2.2 Specification (September 2023) — TC String encoding, CMP requirements
• Kantara Initiative Consent Receipt Specification v1.1 — Standard consent receipt format
• EDPB Guidelines 05/2020 — Consent under Regulation 2016/679