Transcend Docs

Partition Keys

Partitioning preference data with partition keys

Understanding Preference Store Partitions

Partitions allow you to divide your preference data into separate containers, creating multiple isolated preference datasets within a single Transcend instance. Think of partitions as separate preference databases, each serving a specific purpose but managed through the same interface.

Common Uses for Partitions

Organizations typically use partitions for:

  1. Environment Separation: Keeping development, staging, and production environments separate
  2. Multi-Brand Management: Maintaining separate preference datasets for different brands under your organization
  3. Regional Compliance: Managing preferences differently across geographic regions with distinct regulatory requirements
  4. Business Unit Isolation: Separating preference data across different business units or product lines

How Partitions Work

Each partition has a unique partition key that identifies it within your Transcend instance. When you first set up Preference Management, you'll have one default partition with a key matching your Consent Manager bundle ID.

When users update preferences, the changes are stored in the specific partition they're interacting with. This means a user could have different preference settings across your different partitions (for example, different marketing preferences for each of your brands).

Managing Partition Keys

Viewing Your Partitions

To view and manage your partitions:

  1. Go to the Preferences > Developer Settings page in the Admin Dashboard
  2. Click the Open Partition Settings button

Open Partitions Button

Adding New Partitions

To create a new partition:

  1. In the Partition Settings modal, locate the Partitions section
  2. Click Add a new partition
  3. Enter a unique preference key for your new partition
  4. Click Save

You can also copy an existing partition key by clicking the Copy button next to it.

Setting the Default Partition

To change which partition is used by default:

  1. Go to the Change your default partition section
  2. Select the partition you want to set as default
  3. Click Update Partitions

Update Partitions in Partition Settings

Note: Only users with access to the parent organization in Transcend can create new partition keys.

On this page