Page properties
This core reference entry is suited for beginner-level builders.
Learn more about experience levels.
To learn about this topic more in-depth, we recommend reading the suggested articles below:
Elements In this article series, we cover how to work with different element types:
Article: The page
Article series: Elements
Article series: The element hierarchy
Navigation
In this article we cover how to navigate between pages and page sections:
Article: Navigation
Design
Article series focusing on design in general, explaining terminology and offering resources to help you set up a user-friendly, good looking design.
Article series: Design
Article: Responsive design Building pages that work on all devices, such as a laptop and a phone.
The design tab In this article we cover the different tools available in the design tab.
Article: ´The design tab
Article: The element inspector
The tool you use to edit elements.
Previewing your app
In this section about how to preview your app in the development environment.
Article: Previewing your app
Bubble Academy: How to Use the Page Element | Bubble Quick Tip Bubble Academy: Element videos (list of videos related to elements)
The page element is the top-level container for all other elements in a web app.
Every element you place -- such as groups, inputs, text, or repeating groups -- exists inside a page. Page-level settings control overall layout, background style, SEO properties, and other global behaviors that affect everything within it.
Visual
Content
Type of content
Defines the type of data the page holds, such as a User or a custom data type. Unlike containers such as groups and popups, the page's data can be accessed from anywhere on the page using the Current page's thing data source.
Data source
Defines the thing displayed on the page. The Type of content property determines what kind of data can be set as the data source. Child elements can reference it using the Current page's thing data source.
Size
Sets the width and height of the page.
Fixed
Sets the width/height of the page as a fixed value.
Pixels: sets the width to a fixed pixel value
Fill
The page's width and height fills the available space in the browser.
Min: the minimum width/height, defined as a pixel value.
Max: the maximum width/height, defined as a pixel value.
Builder width
Sets the width of the page in the editor, as a work area. This property is only available if width/height is set to Fill.
Layout
Container layout
Defines how the container element positions and arranges its child elements.
You can choose a layout type (such as column, row, align, or fixed), control alignment behavior, and configure spacing. This includes properties for gap (space between child elements), padding (internal spacing), and margin (external spacing). Layout settings determine how the element behaves responsively and how it interacts with surrounding elements.
Column
Arranges child elements vertically, stacking them from top to bottom by default. You can change the
You can control vertical order, horizontal alignment, spacing between items (gap), and whether elements stretch to fill the available width.
Row
Arranges child elements horizontally, placing them side by side from left to right.
You can control horizontal order, vertical alignment, spacing between items (gap), and whether elements stretch to fill the available height.
Align
Places child elements freely within a defined alignment 3x3 grid.
This layout allows positioning elements relative to the container (for example, top-left, center, bottom-right).
Fixed
Positions child elements using explicit X and Y coordinates.
Elements are placed at fixed pixel positions within the container. This layout does not automatically adjust based on content flow and offers the least responsive flexibility.
Alignment
This setting applies to column/row layouts.
Column and row layouts support different alignment modes that control how child elements are positioned along the main and cross axes.
Top/left (start)
Aligns child elements to the start of the container.
In a column layout, elements align to the top.
In a row layout, elements align to the left.
Center
Aligns child elements to the center of the container along the relevant axis.
In a column layout, elements are centered horizontally.
In a row layout, elements are centered vertically.
Right/bottom (end)
Aligns child elements to the end of the container.
In a column layout, elements align to the bottom.
In a row layout, elements align to the right.
Space between
Distributes child elements evenly, with equal space between them and no extra space at the edges of the container.
Space around
Distributes child elements evenly, with equal space around each element. This results in half-sized spacing at the container’s edges compared to the space between elements.
Spacing
Gap (column and row layout)
Defines the space between child elements inside a container.
The gap is applied between items in a column or row layout. It does not add space before the first element or after the last element — only between siblings.
In a column layout, the gap controls vertical spacing.
In a row layout, it controls horizontal spacing.
If child elements also have margins, the gap and margin values are cumulative. For example, a container with a 10 px gap and a child element with a 10 px margin between items will result in 20 px of total space between those elements.
Configure
Page folder
Defines which folder the page is stored in.
Page folders help you organize and categorize pages and reusable elements in the editor. They're purely for structure and clarity during development and have no effect on how the app behaves at runtime. Folders don't change URLs, permissions, navigation, or performance.
Make this page native mobile
The properties below apply to web apps packaged as native mobile apps using a web wrapper. They're not related to the native mobile builder and don't affect apps built with native mobile elements.
Instructs Bubble to handle the page as a native mobile app and lets you provide a name for the app.
Mobile version
Points Bubble to the mobile version of a page.
Style
Style sets the visual design of the element, including properties such as colors, fonts, borders, shadows and other appearance settings.
Styles are shared across elements. When multiple elements use the same style, updating the style will automatically update all elements that reference it.
Style selector
Select the style to apply to the selected element.
Edit style
To edit the style, click the edit style icon. The changes to that style will apply to all elements using that style.
Detach style
Detaching the style will disconnect the element from the current style, but keep the formatting of the style until you make changes to it. This only affects the selected element.
Overriden styles
You can override a style on one or more elements, using the defined style properties but allowing you to make individual changes to styling properties that apply only to the selected element(s).
Overridden styles will be marked with an Overridden labelI.
You can reset the selected element's style by clicking the Reset icon.
Appearance
Opacity
Opacity sets the transparency level of the page. At 100%, it is is fully opaque. At 0%, it is fully transparent (invisible).
Background
Sets the background of the selected element(s) as a color, gradient or image.
Color
Sets the background color in a hex value. You can also set the opacity of the border. Can be a static or the result of a dynamic expression.
Gradient
Sets a gradient color, ranging from a start color and an end color, with an optional mid color.
Linear gradient
A linear gradient is a background effect where colors transition gradually along a straight line.
The gradient follows a defined direction (for example, top to bottom, left to right, or at a specific angle). Instead of a single solid color, the element displays a smooth blend between two or more colors across that line.
Top
The gradient begins at the top and transitions downward.
Left
The gradient begins on the left side and transitions horizontally to the right.
Bottom
The gradient begins at the bottom and transitions upward.
Right
The gradient begins on the right side and transitions horizontally to the left.
Custom
Allows you to define a specific angle for the gradient direction.
Radial gradient
A radial gradient is a background effect where colors transition outward from a central point.
Instead of following a straight line (like a linear gradient), the color spreads in a circular or elliptical shape from the center to the edges.
Radial gradient types
Circle
The gradient expands evenly in all directions from the center, forming a perfect circle.
Ellipse
The gradient expands in an oval shape, stretching more in one direction based on the element’s width and height.
Radial gradient expansion
Define how far the radial gradient extends from its center point.
They control which edge or corner of the element determines the gradient’s final size, affecting how quickly the color transition spreads across the element.
Closest side
The gradient expands from the center until it reaches the nearest side of the element.
Closest corner
The gradient expands from the center until it reaches the nearest corner of the element.
Farthest side
The gradient expands from the center until it reaches the farthest side of the element.
Farthest corner
The gradient expands from the center until it reaches the farthest corner of the element.
Stops
Sets the start and end point of the radial gradient. By default, it has a Start and End. Optionally, you can add an intermediate point by clicking the + symbol next to Stops.
Image
Sets an image as the element's background. The image can be a static file uploaded directly in the editor, or the result of a dynamic expression.
Upload
Upload a static image file to use as the background.
Make dynamic
Click the + icon to define a dynamic expression that returns the image to use as the background.
Interaction
Transitions
Transitions add animation when a style property changes.
Instead of updating instantly, the element gradually shifts from its previous state to the new one over a defined duration. For example, if you reduce an element’s width, a transition can make it smoothly shrink rather than change size immediately.
Transition styles
ease
Starts slowly, speeds up in the middle, and slows down at the end.
ease-in
Starts slowly and accelerates toward the end.
ease-out
Starts quickly and decelerates toward the end.
ease-in-out
Starts slowly, accelerates in the middle, and slows down again at the end.
linear
Moves at a constant speed from start to finish.
step-start
Jumps immediately to the end state at the start of the transition.
step-end
Remains in the start state and jumps to the end state at the very end of the transition.
Transition duration
Transition duration defines how long the transition animation runs, measured in milliseconds.
SEO
Title tag
Sets the page's <title> element. This appears in browser tabs and search engine results.
Meta description
Defines the page's <meta name="description"> content. Search engines may display this text in search results and use it to understand the page's content.
Social (open graph)
Title
Sets the Open Graph title (og:title). Used when the page is shared on social platforms.
Share image
Sets the Open Graph image (og:image). This image is displayed in link previews on social media.
Advanced
ID attribute
A unique identifier assigned to the element. This can be used to reference the element in custom code, such as JavaScript or CSS, using document.getElementById() or CSS selectors.
For this property to be visible, you need to enable Expose the option to add an ID attribute to HTML elements in Settings – Advanced options.
Time zone
This property requires that you check the Enable timezone override controls and Page checkboxes under Settings – General.
Overrides the default browser-based time zone for this page. All date and time elements on the page will use the selected time zone.
HTML header
This property sets an HTML header on one specific page. To apply an HTML header to all pages, go to Settings – SEO and metatags.
Lets you insert custom code into the page's <head> section. Typically used for scripts, meta tags, or third-party integrations.
Last updated
Was this helpful?