Transcend
Integrate Transcend Consent Management with your Mintlify docs to gate analytics behind visitor consent using your existing Transcend bundle.
Use Transcend to manage cookie consent on your documentation site. When you configure Transcend, Mintlify loads your Transcend bundle, shows Transcend’s consent banner, and only loads analytics and feedback after visitors grant consent for the Analytics purpose.
Configure Transcend if you already use it as your consent management platform (CMP) and want a single, consistent consent experience across your product and docs.
When Transcend is configured, Transcend owns the consent banner. Mintlify’s built-in consent banner does not appear, so visitors only see one prompt.
Setup
Get your Transcend bundle ID
In your Transcend dashboard, go to Consent Management and copy the bundle ID for the deployment you want to use with your docs. The bundle ID appears in your Airgap script URL: https://transcend-cdn.com/cm/<bundleId>/airgap.js.
Add Transcend to your docs.json
Add a transcend object under integrations in your docs.json:
"integrations": {
"transcend": {
"bundleId": "YOUR_BUNDLE_ID"
}
}You can also configure Transcend from your dashboard under Analytics → Add integration → Compliance.
Verify the banner loads
Deploy your docs and open the site. The Transcend consent banner should appear on the first visit. Accept, reject, and revoke analytics consent to confirm that analytics scripts follow the visitor’s selection.
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
bundleId | string | Yes | Your Transcend bundle ID. Can only contain letters, numbers, hyphens, and underscores. |
analyticsPurpose | string | No | The Transcend purpose name that gates analytics and feedback. Defaults to Analytics. Set this if you renamed the purpose in Transcend. |
Custom analytics purpose
If you renamed the Analytics purpose in your Transcend instance, pass the exact purpose name so Mintlify waits for consent on the right purpose:
"integrations": {
"transcend": {
"bundleId": "YOUR_BUNDLE_ID",
"analyticsPurpose": "Product Analytics"
}
}How consent gating works
- Analytics and feedback scripts do not load until Transcend resolves the visitor’s consent for the configured purpose.
- If a visitor grants consent and later revokes it, the page reloads so already-loaded analytics scripts are torn down.
- If Transcend fails to load or a visitor never resolves the banner, analytics stay off.