A popup is a container that appears above the rest of the page and is centered on the screen, regardless of how far the user has scrolled. Popups can dim or blur the content behind them, which makes them well suited to grabbing the user's attention with a message, form, or focused action.
Common uses include:
Error messages and alerts
Registration and login forms
Contact and feedback forms
Newsletter signup prompts
Promotional offers and discounts
Confirmation dialogs before destructive actions
Popups can be used to bring attention to your users immediately.
How popups behave
Popups sit in a special layer above the rest of the page. They're always centered horizontally and stay in place as the user scrolls, giving them a consistent, focused appearance regardless of the page's state.
By default, popups dim the page behind them, drawing attention to the popup itself. You can adjust this behavior through the popup's properties, including changing the color of the overlay, adjusting its opacity, or applying a blur effect. Users can typically dismiss a popup by clicking outside of it, though this behavior can be turned off if the popup requires an explicit action to close.
Because popups are their own container, they can hold any elements you'd place in a regular group, including forms, images, buttons, and even other containers.
Loading data into a popup
Popups can hold a data source (see Key terms), just like a regular group. This makes it easy to open a popup with a specific piece of data loaded, such as an "edit user" popup that receives the user being edited.
There are two common patterns:
Set the data source directly
The popup loads its data as soon as it's shown, based on an expression (see Key terms) like Current User.
Setting the data source on a popup makes it load its data as soon as the popup is shown.
Push data with a workflow
Use the Display data in a group/popup action to load a specific item into the popup at the moment it opens. This is the more flexible pattern, since it lets the popup receive different data based on which button was clicked.
Once the data is loaded, child elements inside the popup can reference it with expressions like Parent group's User's name.
Using an action, you can load a specific item into the popup when it opens.
Resetting data in a popup
To clear the data in a popup, you can use the Reset a group/popup action. Note that this resets the data back to its original data source. If the data source is empty, it will reset to an empty value. If the data source isn't empty, it will reset to the original item.
The popup automatically fades when hidden, and the animation takes 500ms. If you reset the data and then hide the popup, you may see the content change during the fade-out. To avoid this, schedule a custom event with a 0.5-second delay that resets the popup's content, so the reset happens after the animation completes.
Showing and hiding popups
Popups don't have the Visible on page load property, so they're hidden when the page loads and can't be shown using conditions. Instead, they're controlled by workflow actions, which you can also run from a Page is loaded event to show a popup as soon as the page loads:
Show an element displays the popup with a subtle fade-in animation.
Hide an element closes the popup with a matching fade-out.
Animate an element displays or hides the popup with a specific animation, such as sliding in from the side or scaling up from the center.
For popups that need to open with specific data, use Display data in a group/popup just before Show an element in the same workflow, so the data is ready before the popup appears.
Popup events
Adding a popup to a page gives you two extra events you can use to trigger workflows:
A popup is opened runs each time the popup is shown, whether through Show an element or Animate an element.
A popup is closed runs each time the popup is hidden (see Key terms).
Both events trigger every time the popup opens or closes, not just the first time. This makes them useful for setting up or cleaning up state around the popup.
Common uses include:
Resetting input fields after the popup closes, so they're empty the next time it opens.
Preloading data when the popup opens.
Logging analytics events tied to popup interactions.
Using multiple popups
You can have as many popups on a page as you need. Only one is typically visible at a time, though. Showing a second popup while the first is open can lead to confusing overlaps, so it's usually better to close the first popup before opening the next one.
Styling popups
Popups can be styled like any other container. The overlay behind the popup can also be customized, giving you control over how much of the page is visible when the popup is open.
Using styles and color variables keeps popups consistent with the rest of your app's design.
Article series: Styles
Popups and security
Popups are a visual layer, not a security boundary. The elements behind a popup are still fully present in the page's client-side code, and a curious user can inspect the page to see them. Dimming or blurring the background is a UI effect only.
Never rely on a popup to hide sensitive information. Use privacy rules in the database and server-side conditions to control what data actually reaches the client.
Using popups as login/signup screens
A common pattern is to use a popup as a login/signup screen that appears if the current user is logged out. This approach should be used with care:
Make sure all database data is protected by privacy rules.
Assume that the user can hide the popup and see what's underneath, even if you use a background color and/or blur.
Assume that if the user logs out, data they had access to before logging out is still loaded and visible.
Protect all sensitive events and actions with server-side conditions.
Generally, we recommend using dedicated pages for login and signup, and redirecting logged-out users to those pages. That said, always assume a user can reach any page, regardless of your setup. This is why privacy rules and server-side conditions matter no matter which method you choose.
Other ways to learn
Core reference: Popup properties
Core reference: Popup properties
In the core reference section, you'll find all the properties associated with popups.
Reference: Popup
FAQ: Popups
Can popups be shown on page load?
Can popups be shown on page load?
Yes, with an action. Popups don't have the Visible on page load property, so trigger the Show an element action from a Page is loaded event instead. You can add a condition to the action to decide whether the popup should open, based on the state of the page or the user.
Can popups be closed by clicking outside of them?
Can popups be closed by clicking outside of them?
Yes. This is the default behavior, but it can be disabled in the popup's properties for popups that require an explicit action to close. Note that this is a UI setting only, not a security measure.
Can I have multiple popups open at the same time?
Can I have multiple popups open at the same time?
Technically yes, but it can lead to confusing layouts as the popups overlap. It's typically better to close one popup before opening the next.
How do I pass data to a popup when I open it?
How do I pass data to a popup when I open it?
Use the Display data in a group/popup action just before Show an element in the same workflow. This loads the data into the popup before it appears, so the elements inside can reference it right away.
How do I reset a popup's inputs when it closes?
How do I reset a popup's inputs when it closes?
Use the A popup is closed event to run Reset relevant inputs or Reset a group/popup, which clears the input values used inside the popup. This way, the popup opens fresh the next time it's shown.
Can I nest containers inside a popup?
Can I nest containers inside a popup?
Yes. Popups can hold any elements, including regular groups and other containers.
Can I make the background transparent or remove the overlay?
Can I make the background transparent or remove the overlay?
Yes. The overlay behind the popup can be styled or made fully transparent, letting you show a floating popup without dimming the page behind it.
Can I open different popups from the same button?
Can I open different popups from the same button?
Yes. Use conditions on the workflow to decide which popup to show based on the current context, or run multiple show actions with their own conditions.
Are popups available in native mobile apps?
Are popups available in native mobile apps?
No. Popups are web-only. For native mobile apps, use sheets instead.
Can I animate the popup as it opens and closes?
Can I animate the popup as it opens and closes?
Yes. Use the Animate an element action to apply a specific animation, such as sliding, scaling, or fading, when the popup appears or disappears.
Note that popups fade in and out over 500ms by default.
Can I show a popup using conditions?
Can I show a popup using conditions?
Not with a condition on the popup itself. Popups don't have the Visible on page load property, so they need to be displayed with an action, such as Show an element or Animate an element. To control when the popup opens, add a condition to that action or to the workflow that runs it.
Key terms
Data source: A data source is any source your app pulls data from, such as a database search, a specific record, an option set, or an external API.
Reference: Data sources
Expression: Dynamic expressions are how you reference and manipulate data in Bubble. They let you pull values from data sources, apply operators, and combine data in different ways to produce a final result, such as Current User's name or Do a search for Posts:count.
Article: Dynamic expressions
Hidden: This event triggers as soon as the popup's hide animation starts. The animation lasts 500ms.



