(function initializeRasaDocsConsent() { // Consent is stored in the `cc_cookie` cookie that rasa.com and hello.rasa.com // read through vanilla-cookieconsent, so one choice covers every Rasa property. // Its schema and cookie attributes must stay compatible with that library. // The localStorage copy is only there because Mintlify gates its own telemetry // on a localStorage key/value pair rather than on a cookie. const COOKIE_NAME = "cc_cookie"; const COOKIE_DAYS = 182; const COOKIE_REVISION = 0; const CONSENT_KEY = "rasa_cookie_consent"; const PREFERENCES_KEY = "rasa_cookie_preferences"; const ACCEPTED_VALUE = "accepted"; const NECESSARY_VALUE = "necessary"; const CATEGORY_SERVICES = { necessary: [], analytics: ["analytics_storage"], marketing: [ "ad_storage", "ad_user_data", "ad_personalization", "personalization_storage", ], }; window.dataLayer = window.dataLayer || []; const isStaging = window.location.hostname.endsWith(".mintlify.site") || window.location.hostname.endsWith(".mintlify.app") || window.location.hostname.includes("staging") || window.location.hostname === "localhost"; const isCanary = document.cookie .split(";") .some((part) => part.trim() === "rasa_mintlify_canary=1"); window.dataLayer.push({ event: "rasa_docs_environment", implementation: "mintlify", rasa_docs_environment: isStaging ? "staging" : "production", rasa_mintlify_canary: isCanary, }); window.gtag = window.gtag || function gtag() { window.dataLayer.push(arguments); }; window.gtag("consent", "default", { ad_storage: "denied", ad_user_data: "denied", ad_personalization: "denied", analytics_storage: "denied", personalization_storage: "denied", functionality_storage: "granted", security_storage: "granted", wait_for_update: 500, }); const existing = readPreferences(); if (existing) applyConsent(existing, false); else { clearMirroredPreferences(); syncPostHog(false); } if (document.readyState === "loading") { document.addEventListener("DOMContentLoaded", mountConsentControls); } else { mountConsentControls(); } function readStoredConsent() { const cookie = document.cookie .split(";") .map((part) => part.trim()) .find((part) => part.startsWith(`${COOKIE_NAME}=`)); if (!cookie) return null; try { const saved = JSON.parse( decodeURIComponent(cookie.slice(COOKIE_NAME.length + 1)) ); // vanilla-cookieconsent treats a record without these as consent not given. if ( !Array.isArray(saved.categories) || typeof saved.consentId !== "string" || !saved.consentTimestamp ) { return null; } return saved; } catch { return null; } } function readPreferences() { const saved = readStoredConsent(); if (!saved) return null; return { analytics: saved.categories.includes("analytics"), marketing: saved.categories.includes("marketing"), }; } function savePreferences(preferences) { const previous = readStoredConsent(); const now = new Date().toISOString(); const categories = ["necessary"]; if (preferences.analytics) categories.push("analytics"); if (preferences.marketing) categories.push("marketing"); writeConsentCookie({ categories, revision: COOKIE_REVISION, data: previous?.data ?? null, consentTimestamp: previous?.consentTimestamp || now, consentId: previous?.consentId || createConsentId(), services: { necessary: CATEGORY_SERVICES.necessary.slice(), analytics: preferences.analytics ? CATEGORY_SERVICES.analytics.slice() : [], marketing: preferences.marketing ? CATEGORY_SERVICES.marketing.slice() : [], }, languageCode: "en", lastConsentTimestamp: now, }); mirrorPreferences(preferences); } function writeConsentCookie(payload) { const host = window.location.hostname.toLowerCase(); const expires = new Date( Date.now() + COOKIE_DAYS * 24 * 60 * 60 * 1000 ).toUTCString(); let cookie = `${COOKIE_NAME}=${encodeURIComponent( JSON.stringify(payload) )}; expires=${expires}; Path=/; SameSite=Lax`; if (host === "rasa.com" || host.endsWith(".rasa.com")) { cookie += "; Domain=.rasa.com"; } if (window.location.protocol === "https:") cookie += "; Secure"; document.cookie = cookie; } function createConsentId() { if (window.crypto?.randomUUID) return window.crypto.randomUUID(); // randomUUID needs a secure context, so build the same v4 shape by hand. const bytes = new Uint8Array(16); window.crypto.getRandomValues(bytes); bytes[6] = (bytes[6] & 0x0f) | 0x40; bytes[8] = (bytes[8] & 0x3f) | 0x80; const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0") ).join(""); return [ hex.slice(0, 8), hex.slice(8, 12), hex.slice(12, 16), hex.slice(16, 20), hex.slice(20), ].join("-"); } function mirrorPreferences(preferences) { try { localStorage.setItem(PREFERENCES_KEY, JSON.stringify(preferences)); localStorage.setItem( CONSENT_KEY, preferences.analytics ? ACCEPTED_VALUE : NECESSARY_VALUE ); } catch { // Storage can be unavailable; the cookie remains the source of truth. } } function clearMirroredPreferences() { try { localStorage.removeItem(PREFERENCES_KEY); localStorage.removeItem(CONSENT_KEY); } catch { // Nothing to clean up when storage is unavailable. } } function applyConsent(preferences, persist = true) { if (persist) savePreferences(preferences); window.gtag("consent", "update", { analytics_storage: preferences.analytics ? "granted" : "denied", ad_storage: preferences.marketing ? "granted" : "denied", ad_user_data: preferences.marketing ? "granted" : "denied", ad_personalization: preferences.marketing ? "granted" : "denied", personalization_storage: preferences.marketing ? "granted" : "denied", }); if (!preferences.analytics) clearAnalyticsCookies(); syncPostHog(preferences.analytics); window.dataLayer.push({ event: "rasa_consent_update", rasa_consent_analytics: preferences.analytics, rasa_consent_marketing: preferences.marketing, }); } function clearAnalyticsCookies() { const domain = window.location.hostname.endsWith("rasa.com") ? "; Domain=.rasa.com" : ""; for (const cookie of document.cookie.split(";")) { const name = cookie.split("=")[0].trim(); if (/^(_ga|_gid|ph_|__ph_)/.test(name)) { document.cookie = `${name}=; Max-Age=0; Path=/${domain}; SameSite=Lax`; document.cookie = `${name}=; Max-Age=0; Path=/; SameSite=Lax`; } } } function syncPostHog(analyticsAllowed, attempts = 0) { if (window.posthog) { if (analyticsAllowed) window.posthog.opt_in_capturing(); else window.posthog.opt_out_capturing(); return; } if (attempts < 20) { setTimeout(() => syncPostHog(analyticsAllowed, attempts + 1), 250); } } function mountConsentControls() { mountFooterControls(); // Mintlify replaces page content during client-side navigation. Remount the // control when a page with the standard footer is rendered. let mountScheduled = false; const observer = new MutationObserver(() => { if (mountScheduled) return; mountScheduled = true; window.requestAnimationFrame(() => { mountScheduled = false; mountFooterControls(); }); }); observer.observe(document.body, { childList: true, subtree: true }); if (!existing) showConsentDialog(); } function mountFooterControls() { const footer = document.getElementById("footer"); if (!footer) return; const branding = footer.querySelector( 'a[href^="https://www.mintlify.com"][href*="poweredBy"]' ); const container = branding?.parentElement || footer.lastElementChild; if (!container) return; let settingsButton = document.getElementById("rasa-cookie-settings"); if (!settingsButton) { settingsButton = document.createElement("button"); settingsButton.id = "rasa-cookie-settings"; settingsButton.type = "button"; settingsButton.textContent = "Privacy choices"; settingsButton.addEventListener("click", showPreferencesDialog); } if (branding) branding.remove(); if (!container.contains(settingsButton)) container.appendChild(settingsButton); } function showConsentDialog() { document.getElementById("rasa-consent-dialog")?.remove(); const dialog = document.createElement("div"); dialog.id = "rasa-consent-dialog"; dialog.className = "rasa-consent-prompt"; dialog.setAttribute("role", "dialog"); dialog.setAttribute("aria-modal", "true"); dialog.setAttribute("aria-labelledby", "rasa-consent-title"); dialog.innerHTML = ` `; dialog.addEventListener("click", (event) => { const action = event.target.closest("button")?.dataset.action; if (!action) return; if (action === "preferences") { showPreferencesDialog(); return; } const preferences = action === "accept" ? { analytics: true, marketing: true } : { analytics: false, marketing: false }; applyConsent(preferences); dialog.remove(); }); document.body.appendChild(dialog); // Focus the dialog itself, not its first control, so no button shows a ring. dialog.querySelector(".rasa-consent-focus").focus(); } function showPreferencesDialog() { document.getElementById("rasa-consent-dialog")?.remove(); const current = readPreferences() || { analytics: false, marketing: false, }; const dialog = document.createElement("div"); dialog.id = "rasa-consent-dialog"; dialog.className = "rasa-consent-overlay"; dialog.setAttribute("role", "dialog"); dialog.setAttribute("aria-modal", "true"); dialog.setAttribute("aria-labelledby", "rasa-consent-title"); dialog.innerHTML = `

We use cookies to keep things running smoothly and improve your experience. You can change your preferences anytime.

Strictly necessary cookiesThese cookies are essential for the proper functioning of the website and cannot be disabled. Performance & analyticsThese cookies collect information about how you use our website. MarketingThese cookies collect marketing information.

`; const close = () => { document.removeEventListener("keydown", onKeydown); dialog.remove(); }; const onKeydown = (event) => { if (event.key === "Escape") close(); }; dialog.addEventListener("click", (event) => { const action = event.target.closest("button")?.dataset.action; if (action === "close") { close(); return; } if (action !== "save") return; applyConsent({ analytics: dialog.querySelector("#rasa-consent-analytics").checked, marketing: dialog.querySelector("#rasa-consent-marketing").checked, }); close(); }); document.addEventListener("keydown", onKeydown); document.body.appendChild(dialog); dialog.querySelector(".rasa-consent-focus").focus(); } })();

🍪 Cookie settings

​Step 1: Upload the license in Studio

Step 1: Upload the license in Studio