Bulk Operations
Bulk Operations let you publish, scan, and sync configuration across multiple sites in a single action. This is essential for agencies and businesses managing consent across many domains.
Plan requirements
Bulk Operations require a plan with multiple domain slots:
| Plan | Domains | Bulk Operations |
|---|---|---|
| Free | 1 | Not available |
| Pro | 3 | Available |
| Business | 10 | Available |
| Enterprise | 50 | Available |
How to access
There are two ways to use Bulk Operations:
- Sites page — select multiple sites using the checkboxes, then choose an action from the bulk actions toolbar
- Bulk Operations page — navigate to the dedicated Bulk Operations page from the sidebar for a full-screen workflow
Available operations
Bulk Publish
Publish consent scripts for all selected sites at once. Each site’s script is compiled with its current configuration and deployed to the CDN. This is equivalent to clicking Publish on each site individually, but saves time when you’ve made changes across multiple sites.
Bulk Scan
Trigger cookie scans for multiple sites simultaneously. Each scan runs independently in a headless browser. Scan results appear in each site’s scan history as they complete.
Config Sync
Copy configuration from a source site to one or more target sites. You choose exactly which configuration fields to sync:
- Banner layout — bar, modal, or preference center
- Colors — primary, accent, text, and background colors
- Consent mode — Google Consent Mode V2 settings
- Geo rules — EU, California, and default consent modes
- Languages — enabled languages and translations
- Cookie categories — category names and descriptions
- Blocking mode — full-blocking, signal-only, or notice-only
Only the fields you select are overwritten on the target sites. All other settings remain unchanged.
Agency workflow
Use Config Sync to maintain consistent consent settings across all your client sites. Set up one site as your template, configure it exactly how you want, then sync to all targets. When you need to make a change, update the template and sync again.
API endpoints
All bulk endpoints accept an array of site IDs and process them asynchronously.
POST /api/v1/bulk/publish Publish multiple sites
Queues publish jobs for each site. Scripts are compiled and deployed to the CDN asynchronously. Returns the number of jobs queued and their initial status.
Request Body
{
"siteIds": ["01HABC...", "01HDEF..."]
} Response
{
"queued": 2,
"jobs": [
{ "siteId": "01HABC...", "status": "queued" },
{ "siteId": "01HDEF...", "status": "queued" }
]
} POST /api/v1/bulk/scan Scan multiple sites
Triggers cookie scans for each site. Scans run independently in headless browsers. Returns 409 for any site that already has a scan in progress.
Request Body
{
"siteIds": ["01HABC...", "01HDEF..."]
} Response
{
"queued": 2,
"jobs": [
{ "siteId": "01HABC...", "status": "queued" },
{ "siteId": "01HDEF...", "status": "queued" }
]
} POST /api/v1/bulk/sync-config Sync config across sites
Copies the specified configuration fields from the source site to all target sites. Only the listed fields are overwritten — all other configuration on the target sites is preserved.
Available fields: bannerLayout, colors, consentMode, geoRules, languages, cookieCategories, blockingMode
Request Body
{
"sourceSiteId": "01HABC...",
"targetSiteIds": ["01HDEF...", "01HGHI..."],
"fields": ["bannerLayout", "consentMode", "geoRules"]
} Response
{
"synced": 2,
"results": [
{ "siteId": "01HDEF...", "status": "synced" },
{ "siteId": "01HGHI...", "status": "synced" }
]
} Publish after syncing
Config Sync updates the site configuration but does not automatically publish. After syncing, use Bulk Publish to deploy the updated scripts to the CDN.