# Osano (/integrations/privacy/osano)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 561 · updated: 2026-07-30 -->
Related: [Privacy integrations](/integrations/privacy/overview.md), [Transcend](/integrations/privacy/transcend.md)

Add [Osano](https://www.osano.com/) cookie consent to your docs with a [custom JavaScript file](/customize/custom-scripts#custom-javascript) in your repository.

## Setup [#setup]

Create an `osano.js` file in your docs repository with the following content:

<CodeGroup>
  <CodeBlockTabs defaultValue="Format" groupId="example+format">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="Format">
        Format
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="Example">
        Example
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

    <CodeBlockTab value="Format">
      ```js  
      var script = document.createElement("script");
      script.src = "OSANO_SCRIPT_URL";
      document.head.appendChild(script);
      ```
    </CodeBlockTab>

    <CodeBlockTab value="Example">
      ```js  
      var script = document.createElement("script");
      script.src = "https://cmp.osano.com/your-tenant-id/your-site-id/osano.js";
      document.head.appendChild(script);
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</CodeGroup>

Replace `OSANO_SCRIPT_URL` with your Osano script URL. Your script URL is the `src` value in the code snippet that Osano generates. Your script URL always starts with `https://cmp.osano.com/` and ends with `/osano.js`.

## Troubleshooting [#troubleshooting]

<Accordion title="Pages not loading with Strict compliance mode">
  If your documentation pages aren't loading properly when using Osano's **Strict** compliance mode, you'll need to add Mintlify's domain to your allowlist to allow images and other assets to load.

  <Steps>
    <Step title="Navigate to Managed Rules">
      In your Osano dashboard, go to **Scripts** → **Managed Rules**.
    </Step>

    <Step title="Add Mintlify domain">
      Add `.mintlify.site/` as a managed rule.

      <Frame>
        <img src="/_assets/18942c3ebab9d91b012c8784634cf464418f8c777ebda30769233249ce3875a7" alt="Osano managed rule" />
      </Frame>

      <Info>
        This ensures that all Mintlify-served assets (including images, stylesheets, and other documentation resources) are treated as essential and load even when Osano blocks uncategorized third-party content.
      </Info>
    </Step>
  </Steps>
</Accordion>