By default, when a visitor clicks the close button on your Viewers widget, it closes permanently for that session. The minimize feature changes this behavior - instead of disappearing, the widget shrinks to a small bubble that visitors can click to reopen.
This gives visitors a second chance to engage without the widget feeling intrusive.
How Minimizing Works
Default behavior (no minimize): Visitor clicks close → widget disappears for the rest of their session.
With minimize enabled: Visitor clicks close → widget shrinks to a small bubble in the corner → visitor can click the bubble to reopen the full widget anytime.
Minimizing keeps your lead capture opportunity alive while respecting visitors who aren’t ready to engage yet.
Enabling Minimize in the Dashboard
- Log in to your Viewers dashboard
- Go to Configure → Embed Code
- Find the Close Button Behavior or Display Settings section
- Select Minimize to bubble instead of Close permanently
- Copy your updated embed code
- Replace the old embed code on your website with the new one (manual installs only - WordPress plugin users don’t need to do this)
Manual Configuration
If you prefer to edit your embed code directly, add the data-close attribute:
html
data-close="minimize"Your full embed code will look something like this:
html
<script
src="https://app.viewers.com/widget/widget.js"
data-token="your-token"
data-close="minimize"
async>
</script>If data-close is not set, the widget defaults to closing permanently.
When to Use Minimize
Enable minimize if:
- You want to maximize lead capture opportunities
- Your widget appears on high-value pages (pricing, product, checkout)
- You notice visitors closing the widget early but staying on your site
- You want a less aggressive feel - visitors can dismiss it temporarily without losing access
Stick with permanent close if:
- You prefer a cleaner experience for visitors who aren’t interested
- Your widget is more of a one-time prompt than an ongoing tool
- You’re using the AI chat module and want it accessible only to visitors who actively keep it open
Minimize + Close Button Removal
If you’re on a PRO plan and have the close button hidden entirely (data-options="noclose"), the minimize feature has no effect - there’s no close button for visitors to click.
You can use one or the other, but not both:
- Minimize: Close button stays visible, but minimizes instead of closing
- No close button: Widget stays open; visitors can’t dismiss it at all
Frequently Asked Questions
Does minimizing affect lead capture? No. Leads are captured when visitors submit their email, regardless of whether they minimize, close, or keep the widget open.
What does the minimized bubble look like? It’s a small, unobtrusive circle in the same corner as your widget. It uses your widget’s color scheme and expands back to the full widget when clicked.
Can I customize the minimized bubble? The bubble automatically matches your widget’s styling. There’s no separate customization for the minimized state.
Is minimize available on the Free plan? Yes. The minimize feature is available on all plans, including Free Forever.
Need Help?
If you have questions about the minimize feature or other display settings, contact us.