CookieFrameDocs

Consent Banner Design

Customize the appearance of your CookieFrame consent banner with colors, layouts, and styling options.

Consent Banner Design

CookieFrame provides extensive customization options to match your consent banner with your website's design. All design settings are available in Settings → Design in your dashboard.

Widget Types

Choose the layout that best fits your website:

TypeDescriptionBest For
BannerFull-width bar at top or bottom of screenMost websites, high visibility
FloatingCompact card in cornerMinimal intrusion, modern sites
DialogCentered modal overlayMaximum attention, important consent
PopupSmall popup windowSecondary consent requests

[SCREENSHOT PLACEHOLDER: Side-by-side comparison of widget types]

Positioning

Banners can be placed at the top or bottom of the viewport. Bottom placement is most common as it doesn't push page content down.

Floating Position

Floating widgets can be positioned in either corner:

  • bottom-left
  • bottom-right

Dialog Position

Dialogs are always centered on screen for maximum visibility.

Colors

Customize your banner colors using hex values:

SettingDescriptionDefault
Primary ColorLinks, accents, and highlights#000000
Background ColorBanner background#FFFFFF
Text ColorBody text#000000
Button BackgroundAccept/Reject button fill#000000
Button TextButton label color#FFFFFF

Use sufficient contrast between text and background colors to ensure accessibility. A contrast ratio of at least 4.5:1 is recommended for body text.

Typography

Text Size

Control the font size across your banner:

SizeBody TextHeadings
Small13pxProportional
Medium14pxProportional
Large16pxProportional

Content Alignment

Align text within the banner:

  • left - Standard reading flow
  • center - Symmetrical appearance
  • right - Right-to-left language support

Buttons

Button Style

StyleDescription
FilledSolid background color
OutlineTransparent with border

Button Radius

Control corner roundness from 0px (square) to 24px (rounded). This applies to all buttons in the banner.

Box Radius

The banner container itself can have rounded corners from 0px to 24px. This is most visible on floating and dialog widget types.

Overlay

For dialog and popup widget types, you can configure a background overlay:

SettingDescriptionRange
Overlay EnabledShow/hide the overlayOn/Off
Overlay ColorBackground color (hex)Any
Overlay OpacityTransparency level0-100%
Overlay BlurBackground blur effectOn/Off

An overlay helps focus user attention on the consent dialog but may feel intrusive. Test with your audience to find the right balance.

Floating Button

When using the floating widget type, you can customize the toggle button that remains visible after the banner is dismissed:

Icon Options

  • cookie - Simple cookie outline
  • cookie-colored - Cookie with color accents
  • fingerprint - Privacy/security themed

Floating Button Colors

The floating button has its own color settings separate from the main banner, allowing it to stand out or blend in as needed.

White Label (Business Plan)

Remove CookieFrame branding and add your own logo.

Upload your logo to display in the consent banner. Supported formats: PNG, JPG, SVG.

SettingOptions
Logo PlacementBanner only, Preferences only, Both
Logo SizeSmall (32px), Medium (40px), Large (52px)

Remove Branding

Enable "Remove Branding" to hide the "Powered by CookieFrame" text from your consent banner.

White label features require a Business plan or higher. Upgrade in Settings → Billing.

Custom CSS (Pro Plan)

For advanced customization beyond the built-in options, inject custom CSS targeting CookieFrame elements.

CSS Selectors

All CookieFrame elements use the .cf- prefix:

/* Main container */
.cf-banner { }

/* Button elements */
.cf-button { }
.cf-button-accept { }
.cf-button-reject { }
.cf-button-preferences { }

/* Text elements */
.cf-title { }
.cf-description { }

/* Category toggles */
.cf-category { }
.cf-toggle { }

Example: Custom Font

.cf-banner {
  font-family: 'Inter', sans-serif;
}

Example: Custom Button Hover

.cf-button-accept:hover {
  transform: scale(1.02);
  transition: transform 0.2s ease;
}

Custom CSS requires a Pro plan or higher. Test thoroughly as CSS changes may affect accessibility and mobile responsiveness.

Plan Limitations

FeatureFreeProBusiness
Widget typesAllAllAll
ColorsAllAllAll
TypographyAllAllAll
Custom CSS
White label
Custom logo

Preview Changes

Use the live preview in Settings → Design to see your changes in real-time before publishing. The preview shows both the initial banner and the preferences dialog.

Next Steps