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

Playboard

You can find the appropriate script at the Installation view in your Playboard instance.

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