Add live widgets to a space home page
Surface live content on a space home page with widgets.
Intermediate · ~10 min · Prerequisites: editor access to a space
Editing a Space's content requires editor or owner access. Viewers can open and read a Space but can't change it.
What you'll do
Insert widgets into the Space Home page to show live, auto-updating views of the Space's content — recent documents, the member list, folder listings, and more — without maintaining those lists by hand.
What widgets do
Widgets are live blocks you embed in the Home page editor. Unlike static text or links, a widget queries the Space at render time, so the data it shows is always current. Add a Recent documents widget and it automatically reflects the latest saves; add a Members widget and it tracks membership as people join or leave.
Widgets complement the static layout you set up in Build a space home page. Use static prose for context and guidance; use widgets for the content that changes.
Add a widget
Open the Home page and place your cursor where the widget should appear. Type / to open the block menu, then search for the widget by name — for example, type /recent to find Recent documents or /members to find Members.
Select the widget from the menu. It inserts immediately and begins loading live data. Most widgets show a configuration panel on first insert where you can set options such as how many items to display.
Common widgets
Recent documents — lists the most recently edited documents in the Space, with the editor's name and a relative timestamp. Useful in the Quick links or Getting started section so members always see what's active.
Members — shows everyone with access to the Space, their role (owner, editor, or viewer), and their avatar. Pairs well with a Useful contacts heading.
Folder contents — displays the documents and subfolders inside a specific folder you choose. Use this to surface a curated folder without asking members to browse to it.
For the complete widget catalogue and per-widget options, see The home page.
Arrange and remove
Drag a widget block to reorder it relative to other blocks, just like any other content block. Click the widget to select it; a toolbar appears with Options (to reconfigure) and a Delete icon.
Keep the Home page to a single screen's worth of content when possible. If you find yourself stacking many widgets, consider whether some belong in a dedicated document linked from the page instead.