Widgets are interactive components you add to sections in the Builder. They provide functionality like filtering data, displaying charts, and adding text content.
Available Widgets
The Components panel organizes widgets into five categories: Information, Data, Filters, Charts, and Page elements.
Information: includes Users, Bookmarks, Comments, and AI Chat for navigation and collaboration.
AI: includes the AI Chat widget, which embeds an AI assistant directly in your interface. Users can ask questions about the map data in plain language and get answers without leaving the interface.
Data: provides Table, Numbers, and Featured list for working with datasets.
Filters: contains two filter widgets:
- Attribute filter — lets users filter vector datasets by field values (formerly called "Filter").
- Spatial filter — lets users filter datasets by geography. Users can drop a pin to create a circle or isochrone area, or draw a custom shape using freehand or polygon mode. Drawn polygons can be dragged to reposition after creation. The spatial filter applies only to datasets included in the current interface (formerly called "Mask filter").
Charts: offers Categories, Histogram, and Pie chart for visualization.
Page elements: contains Text, Image, Button, and Divider for layout and content.
Project elements: includes Project title for displaying project information.
Add a Widget
Click the Components tab in the right panel to view available widgets. Drag a widget from the panel into a section on the canvas. The widget appears in the section and becomes selected automatically.
Configure Widgets
Select a widget to view its settings in the right panel. The panel switches to show two tabs: Setup and Options. Setup contains widget-specific configuration like title and data source. Options includes appearance and behavior settings.
Each widget type has unique settings. Text widgets configure title, description, alignment, and HTML support. Attribute filter widgets set which fields users can filter. Spatial filter widgets configure drawing mode and the datasets they apply to. Chart widgets define data sources and visualization options. Settings update immediately as you change them.
Move Widgets
Select a widget by clicking it on the canvas. A blue outline appears around selected widgets. Click and drag the selected widget to reposition it within a section or move it to a different section. Release to drop the widget in the new location.
Delete Widgets
Select the widget you want to remove. Open its settings in the right panel. Scroll to the bottom and click Delete in the Danger zone. The widget is removed permanently from the interface.
Button Widgets
Button widgets let editors place action buttons in an interface that write data back to a dataset. Each button is configured with a specific action and a set of allowed columns:
- Add record — inserts a new row into the dataset with values the editor pre-fills or the user provides via a form.
- Update record — updates fields on an existing record, typically the one selected on the map.
Viewer access for button widgets
By default, only editors can trigger button widget actions. Editors can enable viewer access per button widget in the widget's Setup tab. When enabled, viewers and anonymous users on public interfaces can also trigger the action — but only for the columns the editor has explicitly configured. Atlas validates every submission against the widget configuration before writing.
Datatable Widget: Allow Viewer Editing
The datatable (Table) widget includes an Allow viewer editing toggle in its Options tab. When enabled:
- Viewers can edit cells directly in the datatable, just like editors.
- System columns (Created at, Modified at), computed fields, relation columns, lookup columns, and formula fields remain read-only regardless of this setting.
- Editors retain full edit access as before.
This option is off by default. Enable it when you want field teams or external users to fill in data without needing a full editor seat.