Setting display rules is one of the most important steps in making your widget feel helpful, not intrusive. Claspo templates come with default settings that are designed to be user-friendly — but you can always go further. Tailor when and how your widget appears to match your visitors’ behavior and goals more precisely.
Display frequency
Control how often your widget appears to avoid annoying repeat visitors. By default, widgets are set to display once per session — a good choice for most use cases. But if you need to increase visibility or limit exposure, you can adjust this setting in just a few clicks. You can also choose from the following options:
Do not limit — show the widget as often as the display conditions are met.
Show once — the widget will appear only a single time to each visitor.
Custom limit (one time per) — set a specific number of minutes, hours, days, weeks the widget can appear.
When to display and stop displaying
When setting display conditions, you’ll be asked whether the widget should appear when any condition is met, or only when all are satisfied. Here’s how to decide which to use:
When any condition is met (OR logic) — this option is useful when you want to catch engaged visitors through multiple signals — like scrolling down, spending 20 seconds on a page, etc. If the user does any one of these, the widget will appear.
When all conditions are met (AND logic) — choose this when you want to target a narrow, specific audience. For example, you might display a discount pop-up only if someone has spent at least 20 seconds on the page and is trying to leave (rules: spent 20 seconds on the page + exit intent).
Immediately — use this with caution. It’s best reserved for legal or critical widgets like Age Gates, where immediate display is necessary. In other cases, we recommend letting the user get oriented on the page first.
When it comes to specific behavioral triggers, you can choose from the following options:
Spent on the page.
Spent on the website.
Read the page by N%.
Visited N pages.
Not active on the page N seconds, minutes, hours.
Exit intent.
To make your widget truly effective, base your triggers on real data. Look at your website analytics to find out: the average session duration, typical scroll depth, pages per session. This helps you set realistic conditions that match how your visitors actually interact with your site. For example, if users typically stay for 45 seconds, you might trigger a widget after 30 seconds to catch them at the right moment.
If you don’t have access to this data yet, don’t worry — Claspo provides system-recommended values based on industry averages, so you can start with those and optimize later.
To keep things user-friendly, it’s just as important to control when the widget stops showing. You can set the rule ‘Stop after the user closes the widget X times’ — so they’re not bothered again after showing disinterest. If this is a subscription form, leave the default options — ‘After subscription’ and ‘From any widget’ — enabled.
Important!
The available display conditions depend on the widget type and layout:
Some display conditions depend on the widget type.
For example, to ensure the Age gate works correctly, you need to set the combination:
|
Claspo widgets are designed to be non-intrusive, thanks to our built-in Annoyance Safeguard. No setup is needed — everything runs automatically. You can learn more here.
Choose to whom to show the widget
Tailor your widget experience based on who is visiting your site and how they are browsing.
Personalize by visitor type and device
Claspo allows you to target specific visitor segments, such as:
First-time visitors — you can use this setting to welcome new users with a special offer, lead magnet, or product tour, since they’re unfamiliar with your brand.
Returning visitors — show them exclusive returning-user discounts, invite them to join your loyalty or referral program, share new arrivals or updates.
Also, you can choose where the widget appears — desktop-only, mobile-only, or both (default). This ensures that your message fits the context:
Desktop-only widgets work best for larger forms.
Mobile-only widgets are ideal when you’re promoting mobile-exclusive offers.
Specific page visitors
By configuring this setting, you can personalize the user experience. Click on Add condition and select the desired option from the drop-down list.
URL-based targeting
To get started, click Add condition, then select URL from the drop-down list. From there, you can choose:
Equals — add an entire link and use this for a single, specific page (such as the homepage or a special promo page).
Starts with, contains one of, ends with, regex — target a group of pages that share a common keyword in the URL.
This is especially useful for category-based targeting. For example, in a clothing store:
All women’s product URLs include the word ‘womens’ (like https://yourshop.com/collections/womens/products/the-lilac-italian-...).
All men’s product URLs include ‘mens’ (like https://yourshop.com/collections/mens/products/the-morgans-wide-leg-...).
So, we’ll set the widget condition to URL => Contains one of => womens.
The widget will now appear only on women’s product pages. The same way you can set a condition for the cart or checkout page to display exit-intent popups with a discount to reduce abandonment. Similarly, you can exclude any pages from the widget display.
UTM targeting
UTM parameters are special tags added to URLs that help you track the origin of your traffic. Claspo allows you to use these UTM tags to show specific widgets to users based on how they landed on your site. This is a powerful way to personalize messaging depending on the ad or content that brought the visitor in.
UTM tags are saved for the entire session — not just the first page.
This means if a visitor lands on your site through a link like https://example.com/?utm_source=pixel and then continues browsing to another page (like https://example.com/page2), the utm_source=pixel tag won’t appear in the new URL — but it’s still tracked in the background for the duration of the session.
Why it matters: you can still target or personalize content based on where the visitor came from, even if they’ve clicked around your site. This helps you keep your marketing logic consistent and relevant throughout their visit. |
In the display conditions, click Add condition, then select UTM. You’ll be able to choose from different tag types:
UTM source — traffic source that tells you where the visitor came from (like Facebook, Instagram, etc.). Use this to show widgets only to users from specific sources.
UTM medium — traffic type or channel. Defines how the traffic arrived (CPC, email, social). For example, you can display a different widget for email newsletter traffic.
UTM campaign — this is the custom label you gave your marketing campaign. Great for running themed widgets that match the look and goal of the campaign.
UTM term — keyword that is usually used in paid search (Google Ads), this shows the keyword a visitor searched. Use it to align widget messaging with user intent.
UTM content — indicates which specific link or ad the user clicked on (such as blue button or header banner). Using it, you can show a widget tied to users who clicked on the blue CTA button in your email.
Data Layer event
The Data Layer lets you create more precise and relevant widget display conditions by taking into account both page context and user actions. If you’d like a full walkthrough on how to configure this, check out the step-by-step guide here.
Local Storage values
Local Storage is a browser-based storage method that allows websites to save data on a user’s device, even after the page is refreshed or the browser is closed. This data is local (not sent to a server) and only accessible within the same domain — so ‘yourshop.com’ can’t read what’s saved on ‘anotherstore.com’. This makes Local Storage a useful tool for triggering widgets based on a visitor’s previous actions, preferences, or behavior patterns.
In display conditions On pages, you’ll find the Local storage key option. You can use it to check:
If a key exists at all — is set.
If a key has a specific value — equals.
If a key matches part of a value using conditions like starts with, contains one of, or ends with.
If a key’s value is numerical (greater than, less than).
If a value matches a regular expression (regex).
Common use case examples
Check if a key is set. Use this when you just need to know whether a key exists, regardless of its value. For example, you can show a discount to users who already completed a survey:
Key — quiz_completed
Condition — is set
Use numerical comparisons to trigger widgets based on how many times a user has done something. For example, display a special offer after a user has viewed products more than 3 times — a great way to target warm leads:
Key — productViews
Condition — greater than → 3
Check for specific values inside a key — helpful for category-based targeting. For instance, show a promo to users who browsed shoes or accessories:
Key — CategoryViewed
Condition — contains one of → shoes, accessories
Cookie values
Use cookies to control widget visibility based on stored browser data. In Claspo, this lets you personalize the experience using information like user activity, preferences, or visit history.
Important!
|
You can check:
If a cookie exists (is set).
If its value meets certain conditions (equals, starts/ends with, contains one of, greater/less than, or regex)
Use case examples
1. The user came from a partner site and we want to show them a widget with an exclusive coupon or a special welcome message. Cookie example: referral = partner123. The condition in Claspo:
Name — referral
Condition — equals → partner123
2. Target based on interest categories. If you store category history in a cookie, you can trigger widgets to promote a relevant offer or accessory bundle. Claspo’s condition example:
Name — lastViewedCategory
Condition — contains one of → laptops, smartphones, headphones
You can also exclude users who have already redeemed a promotion to prevent showing the same discount to someone who’s already used it. Exclusion condition:
Name — hasDiscount
Condition — equals → true
3. Follow up on video/demo engagement. If the user watched a product video or demo, follow up with a lead capture widget, offering a downloadable PDF or ‘Talk to an expert’ form. Claspo’s condition example:
Name — videoWatched
Condition — equals → true
Target by location
Claspo’s location-based display rules let you tailor widget visibility based on where your visitors are. This is especially useful for region-specific promotions and local compliance requirements.
In the In locations section, you can choose one of the following options:
Show in all locations — default option. The widget appears for everyone, regardless of location.
Show in selected locations — the widget appears only in the countries, regions, or cities you select.
Do not show in selected locations — use this to exclude specific locations from seeing the widget.
Click Select locations to choose your targeting level:
Filter by country.
Drill down into regions or cities within that country.
Use the search bar to quickly find a location.
Use case examples:
Localized promotions: show a free shipping banner to users in states where your logistics partner offers next-day delivery. Target: Selected cities or regions.
Event-specific widgets: promote an in-person sale or event only to users near that location. Target: One specific city.
Country-specific legal notices or age gates: only display an age verification widget in countries where it's legally required. Target: Selected countries.
Display rules turn widgets into timely, relevant experiences. With Claspo, you can target by behavior, location, traffic source, or stored data. The more relevant the widget, the better the results.