Section (ALPHA)
Responsive Widgets are in alpha and available by invitation only on Business and Enterprise plans. Behavior and properties may change. To request access, open a support ticket and name the feature Responsive Widgets (ALPHA).
A Section is a layout container that spans the full width of the page. It holds only Zones, and you place your other widgets inside those Zones. Use Sections to split a page into horizontal bands, such as a header area, a filter bar, and a results area.
Widget type: SECTION_WIDGET

How a Section arranges its content
- A Section always takes the full width of the page.
- A Section can hold only Zone widgets. You cannot drop other widgets directly into a Section.
- Zones sit side by side in one row, with a small gap between them.
- A Section holds up to 4 Zones. A new Section starts with 1 Zone.
- The Section width is split into 12 columns. You decide how many columns each Zone gets.
The Section does not appear as a card in the widget pane. Appsmith adds it for you, for example when you drop a widget onto an empty part of the page.
Content properties
These properties appear in the Content tab of the property pane.
Section Split
Zone widths (splitter)
A visual control with no label. It shows the 12 columns of the Section. Drag it to share those 12 columns between the Zones.
Zones
Sets how many Zones the Section has. Use the stepper to add or remove Zones. A Section holds up to 4 Zones.
General
Scroll contents boolean
Caps the Section height at Max height (px) and lets users scroll the content inside. Off by default.
Max height (px) number
The highest the Section can grow, in pixels, when Scroll contents is on. The value must be 100 or more. The placeholder shows 400.
This property shows only when Scroll contents is on.
Visible boolean
Controls whether the Section shows in the app. On by default.
Animate loading boolean
Shows a loading animation while the Section loads. On by default.
Style properties
These properties appear in the Style tab of the property pane.
General
Visual Separation boolean
Gives the Section an elevated background and borders from the theme. Use it to set this Section apart from the other Sections on the page. Off by default.
Custom styling
These settings are in the Custom styling section, at the end of the Style tab. An empty setting uses the theme value. For theme colors, dark mode, and the rules for custom CSS, see Custom styling.
Accent color string
Builds the hover, pressed, focus, and text colors of this widget from one color, in light and dark mode. Lists and menus that the widget opens use them too. Empty means the accent of the nearest container that sets one, or the theme accent.
Background string
Sets the background of the Section. Takes a custom color or a gradient, not a theme color.
Examples:
#6366f1
linear-gradient(135deg, #6366f1, #8b5cf6)
Text color string
Sets the text color of the widget surface. Takes a theme color or a custom color. When it is empty and Background is set, the widget picks a readable text color.
Border color string
Sets the border color of the widget surface. Takes a theme color or a custom color. A color with no Border width draws a thin border.
Border width string
Sets the border width of the widget surface. Options: From theme (default), None, Thin, Medium, Thick. You cannot bind this property.
Corners string
Sets the corner radius of the widget surface. Options: From theme (default), Sharp, Rounded, Pill. You cannot bind this property.
Custom CSS string
Adds plain CSS to this widget. Rules apply only inside the widget, and & is the widget surface. You cannot bind this property.
Reference properties
Reference properties let you read the widget's state in bindings and code, for example {{Section1.isVisible}}. You cannot set them directly.
isVisible boolean
Shows whether the Section is visible.
Example:
{{Section1.isVisible}}
Methods
Methods let you change the widget's properties from code, for example in a JS Object.
setVisibility (param: boolean): Promise
Shows or hides the Section.
Example:
Section1.setVisibility(false)