Cookie Declaration

Learn how to integrate and customize the Cookie Declaration feature on your website

Overview

The Cookie Declaration feature provides a comprehensive, automatically updated list of all cookies used on your website. This dynamic declaration ensures your cookie policy stays current and compliant with privacy regulations like GDPR and CCPA.

A Cookie Declaration is a detailed list that shows:

  • All cookies present on your website
  • Their purpose and functionality
  • Duration and expiration times
  • Whether they are essential or optional
  • Which third-party services use them

Unlike static cookie policies that require manual updates, Visible Privacy's Cookie Declaration automatically scans and updates your cookie list in real-time.

Integration

Basic Script Integration

To add the Cookie Declaration to your website, simply include this script tag where you want the declaration to appear:

<script async type="text/javascript" src="https://bc-prod-config.empathy.co/[CLIENT_ID]/cookieDeclaration.js"></script>

Finding Your Client ID

  1. Log into your Visible Privacy Playboard
  2. Navigate to Installation → Your Client ID
  3. Copy your Client ID from the configuration section
  4. Replace [CLIENT_ID] in the script with your actual ID

Implementation Example

Here's how to integrate the Cookie Declaration into a typical website structure:

cookie-policy.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Cookie Policy - Your Website</title>
</head>
<body>
    <h1>Cookie Policy</h1>
    <p>Learn about how we use cookies and how you can manage your preferences.</p>
    
    <!-- Cookie Declaration Integration -->
    <div id="cookie-declaration">
        <script async type="text/javascript" src="https://bc-prod-config.empathy.co/YOUR_CLIENT_ID/cookieDeclaration.js"></script>
    </div>
</body>
</html>

Customization Options

Styling Integration

The Cookie Declaration inherits your website's styling but can be customized using the following CSS classes:

/* Main container styling */
.vp-cookie-declaration-container {}

/* Consent status section */
.vp-cookie-declaration-consent-status {}

/* Category sections */
.vp-cookie-declaration-category-section {}

/* Category headers */
.vp-cookie-declaration-category-header {}

/* Category descriptions */
.vp-cookie-declaration-category-description {}

/* Cookie table styling */
.vp-cookie-declaration-table {}

.vp-cookie-declaration-table th {}

.vp-cookie-declaration-table td {}

.vp-cookie-declaration-table tr:hover {}

Language Support

The Cookie Declaration automatically detects your website's language and displays content accordingly. Supported languages include:

  • English
  • Spanish
  • French
  • German
  • Italian
  • Portuguese
  • Polish

Best Practices

Placement Recommendations

  • Dedicated Cookie Policy Page: Create a standalone page for your cookie declaration
  • Footer Links: Always link to your cookie policy from your website footer
  • Privacy Center: Include it as part of a comprehensive privacy center
  • Regular Reviews: While automatic, periodically review the declaration for accuracy
  • Privacy Policy Integration: Ensure your privacy policy references the cookie declaration
  • Consent Management: Use alongside Visible Privacy's consent management solution

User Experience

  • Clear Navigation: Make your cookie policy easily accessible
  • Mobile Optimization: Test the declaration on mobile devices

The Cookie Declaration automatically categorizes cookies into different types:

Technical Cookies

Essential cookies required for basic website functionality:

  • Session management
  • Security features
  • Load balancing
  • Basic navigation

Preference Cookies

Cookies that enhance user experience:

  • Language preferences
  • Theme settings
  • Personalization options
  • Accessibility features

Analytics Cookies

Cookies used for website analytics and performance:

  • Google Analytics
  • Traffic analysis
  • Performance monitoring
  • User behavior tracking

Marketing Cookies

Cookies used for advertising and marketing:

  • Targeted advertising
  • Conversion tracking
  • Social media integration
  • Remarketing campaigns

Troubleshooting

Common Issues

Script Not Loading:

  • Verify your Client ID is correct
  • Check for JavaScript errors in browser console
  • Ensure the script is not blocked by ad blockers

Outdated Cookie Information:

  • The declaration updates automatically, but changes may take up to 24 hours
  • Clear your browser cache if you don't see recent changes
  • Contact support if issues persist

Styling Issues:

  • Check for CSS conflicts with your website theme
  • Use browser developer tools to inspect styling
  • Apply custom CSS if needed