> ## Documentation Index
> Fetch the complete documentation index at: https://tomee-mintlify-2b1ef2b2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Transcend

> Integrate Transcend Consent Management with your Mintlify docs to gate analytics behind visitor consent using your existing Transcend bundle.

Use [Transcend](https://transcend.io/) 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.

<Note>
  When Transcend is configured, Transcend owns the consent banner. Mintlify's built-in consent banner does not appear, so visitors only see one prompt.
</Note>

## Setup

<Steps>
  <Step title="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`.
  </Step>

  <Step title="Add Transcend to your docs.json">
    Add a `transcend` object under `integrations` in your `docs.json`:

    ```json theme={null}
    "integrations": {
      "transcend": {
        "bundleId": "YOUR_BUNDLE_ID"
      }
    }
    ```

    You can also configure Transcend from your dashboard under **Analytics** → **Add integration** → **Compliance**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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:

```json theme={null}
"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.