Skip to main content

Cookie Settings

Cookie settings control how often your popup appears to returning visitors. Use them to prevent annoying users with repeated displays while still reaching your audience.

How Cookies Work​

When a visitor interacts with your popup:

  1. XBuilder sets a browser cookie
  2. Cookie stores display/dismiss information
  3. On return visits, XBuilder checks the cookie
  4. Popup behavior follows cookie settings

Display Frequency Options​

Show Every Time​

Popup appears on every page load.

Use CaseGood For
TestingDuring development
Critical noticesMust-see content
Session-specificEach browsing session

Once Per Session​

Popup appears once until browser closes.

Use CaseGood For
Welcome messagesNew visitors
Session offersBrowse-time promotions
General engagementNon-aggressive capture

Once Per Day​

Popup appears once every 24 hours.

Use CaseGood For
Daily offersRotating promotions
News/updatesRegular announcements
Moderate engagementBalanced approach

Once Per Week​

Popup appears once every 7 days.

Use CaseGood For
Major announcementsImportant updates
Newsletter remindersGentle re-engagement
Long-term campaignsExtended promotions

Once Ever​

Popup appears only once, permanently remembered.

Use CaseGood For
First-time welcomeOnboarding
Terms acceptanceLegal requirements
One-time offersSpecial discounts

Custom Duration​

Set specific cookie duration:

1 hour
12 hours
3 days
30 days
90 days
365 days

Configuration​

  1. Go to Behavior tab
  2. Find Display Frequency section
  3. Select duration option
  4. Or enter custom duration

When the cookie is set:

OptionCookie Set When
On DisplayWhen popup shows
On CloseWhen user closes
On ActionWhen user takes action

On Load​

Cookie set: When popup displays
Result: Won't show again until cookie expires

Exit Intent​

Cookie set: When popup displays
Result: Won't trigger again until cookie expires

Scroll/Timed​

Cookie set: When popup displays
Result: Won't show on scroll/time again

Advanced Settings​

XBuilder uses unique cookie names per popup:

xbuilder_popup_{popup_id}
ScopeEffect
Site-wideSame cookie across all pages
Page-specificDifferent per page (rarely used)

Multiple Popups​

Each popup has independent cookies. Showing one popup doesn't affect others.

Test Mode​

Enabling Test Mode​

For development and testing:

  1. Go to Behavior tab
  2. Enable Test Mode
  3. Popup ignores cookie settings
  4. Shows every time for testing
Remember

Disable test mode before publishing!

To reset cookies during testing:

  1. Open browser DevTools
  2. Go to Application → Cookies
  3. Delete xbuilder_popup_* cookies
  4. Refresh page

User Privacy​

GDPR Considerations​

XBuilder cookies are:

  • First-party cookies
  • Functional (not tracking)
  • Required for popup functionality

Consider:

  • Mentioning in privacy policy
  • May be exempt from cookie consent
  • No personal data stored

If your site has a cookie consent popup:

  1. XBuilder respects existing consent
  2. Consider categorizing as "functional"
  3. May delay popup until consent given

Best Practices​

Frequency Guidelines​

Popup TypeRecommended
Welcome/onboardingOnce ever
Newsletter signupOnce per week
PromotionsOnce per session
AnnouncementsOnce per day
Exit intentOnce per session
Floating offersCustom (3-7 days)

User Experience​

  1. Don't overdo it — Frequent popups annoy users
  2. Respect dismissal — If closed, don't show immediately
  3. Match urgency — Important = more often
  4. Test with users — Get feedback on frequency

Technical Considerations​

  1. Incognito mode — Cookies reset each session
  2. Multiple devices — Cookies are device-specific
  3. Cookie blockers — Some users block cookies
  4. Browser settings — Users can clear cookies

Troubleshooting​

Check:

  • Test mode is disabled
  • Cookie duration is set
  • Browser accepts cookies
  • No browser extensions blocking

Check:

  • Cookie hasn't been set permanently
  • Clear cookies to reset
  • Check cookie duration setting

Inconsistent Behavior​

Check:

  • Cookie name conflicts
  • Multiple popups interfering
  • Browser cookie settings
  • Third-party cookie policies

Debugging Cookies​

View Cookies​

In browser DevTools:

  1. Press F12 / Cmd+Option+I
  2. Go to Application tab
  3. Expand Cookies → your domain
  4. Look for xbuilder_popup_*
Name: xbuilder_popup_abc123
Value: shown|1704067200
Expires: [cookie expiry date]

Manual Reset​

Delete specific cookie:

  1. Find cookie in DevTools
  2. Right-click → Delete
  3. Refresh page