Osano
Integrate Osano with your Mintlify documentation site to manage cookie consent banners, privacy preferences, and regulatory compliance.
Add Osano cookie consent to your docs with a custom JavaScript file in your repository.
Create an osano.js file inside your content directory with the following content.
var script = document.createElement("script");
script.src = "OSANO_SCRIPT_URL";
document.head.appendChild(script);var script = document.createElement("script");
script.src = "https://cmp.osano.com/your-tenant-id/your-site-id/osano.js";
document.head.appendChild(script);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.
Mintlify includes any .js file inside your content directory on every page of your site, so you don't need to register osano.js in docs.json.
Verify the banner
Section titled “Verify the banner”After you deploy, open your site in a private or incognito window and confirm the Osano consent banner appears. If it doesn't, check the browser console for errors loading osano.js and confirm the script URL matches the one from your Osano dashboard.
Troubleshooting
Section titled “Troubleshooting”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.
Add Mintlify domain
Add
.mintlify.site/as a managed rule.