Quick Start Guide

Get ConsentTrustee running on your website in just a few minutes.

1. Add Your Domain

First, add your website domain in the ConsentTrustee dashboard. Go to Dashboard > Domains and click Add Domain.

Enter your domain name (e.g., example.com). A unique slug will be generated for your integration.

2. Configure Your Banner

Customize your consent banner appearance and behavior. You can choose from pre-built templates (GDPR, CCPA, ePrivacy, LGPD, PIPEDA) or create a custom design.

Available Options

  • Position: Top, Bottom, Bottom-Left, Bottom-Right, or Center (modal)
  • Layout: Bar, Box, or Popup
  • Colors: Primary color, background, and text colors
  • Blocking Mode: Block all scripts until consent is given
  • Languages: Support for 9 languages with customizable translations

3. Install the Script

Add the ConsentTrustee script to your website. Place it in the <head> section of your HTML, before any other scripts that set cookies.

<script
  src="https://api.consenttrustee.com/runtime/consenttrustee.js"
  data-ct-slug="your-domain-slug"
  async>
</script>

Important

Replace your-domain-slug with the slug from your domain settings in the dashboard.

4. Block Scripts Until Consent

To comply with GDPR and other privacy regulations, you should block analytics and marketing scripts until the user gives consent. Change the script type and add a category attribute.

Before (runs immediately)

<script>
  // Google Analytics code
  gtag('config', 'GA_MEASUREMENT_ID');
</script>

After (blocked until consent)

<script type="text/plain" data-ct-category="statistics">
  // Google Analytics code
  gtag('config', 'GA_MEASUREMENT_ID');
</script>

Consent Categories

necessary

Always enabled, essential for site function

preferences

Remember user settings and preferences

statistics

Analytics and performance tracking

marketing

Advertising and remarketing scripts

5. Blocking External Scripts

For external scripts (like Google Analytics), change the src attribute todata-ct-src to prevent the browser from loading them until consent is given.

<!-- Before -->
<script src="https://www.googletagmanager.com/gtag/js?id=GA_ID"></script>

<!-- After -->
<script
  type="text/plain"
  data-ct-category="statistics"
  data-ct-src="https://www.googletagmanager.com/gtag/js?id=GA_ID">
</script>

6. Cookie Declaration Page

ConsentTrustee automatically creates a public cookie declaration page for your domain. Link to it from your privacy policy or footer.

<a href="https://app.consenttrustee.com/cookies/your-domain-slug">
  Cookie Declaration
</a>

The cookie declaration is automatically populated when you run a cookie scan from the dashboard. We recommend scanning your site regularly to keep the declaration up to date.

7. Testing Your Integration

After installation, verify everything is working correctly:

  1. Clear your cookies and reload the page. The consent banner should appear.
  2. Open DevTools (F12) and check the Console for any errors.
  3. Check script blocking: Before giving consent, blocked scripts should havetype="text/plain" and not execute.
  4. Give consent and verify that scripts are now executing properly.
  5. Check the dashboard to see if consent events are being recorded.

Pro Tip

Use browser incognito/private mode for testing to avoid cached consent preferences.

Troubleshooting

Banner not appearing

  • Check that the script is loaded before other scripts
  • Verify the data-ct-slug matches your domain slug
  • Check browser console for JavaScript errors
  • Ensure the domain is verified in the dashboard

Scripts still running before consent

  • Ensure scripts have type="text/plain"
  • Add the correct data-ct-category attribute
  • For external scripts, use data-ct-src instead of src

Consent not being recorded

  • Check network requests in DevTools for API calls
  • Verify CORS settings if running on a subdomain
  • Ensure the domain is active and not in test mode

Next Steps

JavaScript SDK

Learn about the client-side API and events

Run a Scan

Detect cookies on your website