Skip to main content

Record selector widget

Add a Record Selector widget, pick its source table and connect grids, charts, summary cards and details to show the selected record.

Written by Emma Montgomery

A Record Selector widget lets a dashboard viewer pick one record from a dropdown or a list. Every widget connected to it then shows that record's data. Think of it as the steering wheel of a dashboard: pick a vendor, and the details and the other connected widgets turn to that vendor.

Here is the test: should the whole dashboard follow one chosen vendor, customer or project? If yes, add a Record Selector and connect the other widgets to it. To narrow widgets by a category rather than a record, use the Filter widget instead; see Dashboards: Filter Widget.

Example: a Vendor Management solution with a Vendors table. On the Vendor risk overview dashboard, the Security lead adds a Record Selector called Pick a vendor in Dropdown style, sorted by Vendor Name. A Record Details widget takes it as its source. Procurement opens the dropdown, searches for a vendor and picks it; the details refresh at once.

Pick a vendor on the left of the overview with its dropdown open, and the Record Details widget on the right showing the chosen vendor.

Pick a vendor on the left of the overview with its dropdown open, and the Record Details widget on the right showing the chosen vendor.

Plan Availability

All plan types.

Permissions

Solution Managers and members with Full Access add and set up widgets on a public dashboard; the owner does so on a private one; viewers pick only among the records they can access.

Platform

Web

Related Reading


Adding a Record Selector widget

  1. Open the dashboard and set the View | Edit switch in the upper right to Edit.

  2. Select + Add Widget in the toolbar. The Add New Widget panel opens at the right, with a Search Widget box and thirteen collapsible categories. Only Page Display is open to start. Type a word in the search box to filter the cards.

  3. Open the Record Display category and find the Record Selector card. Its description reads "Select a record from the list".

  4. Select the card. A full-width window opens, titled Record Selector. The left side is a live preview and the right side is the settings sidebar, with two tabs: General and Style. Cancel closes the window without placing the widget.

  5. Set the selector up with the sections below, then select Add Widget.

The first widget on a dashboard lands at the top left, at half the row's width; the next lands beside it. Drag the handle on its right or bottom edge to resize it, and the handle in its header to move it. Put it where a viewer looks first, at the top or on the left. See Manage widgets on a dashboard.

The Record Selector window on the General tab, with the preview dropdown showing the first vendor.

The Record Selector window on the General tab, with the preview dropdown showing the first vendor.


The General tab

The General tab holds four sections: Heading, Source, Selection Dropdown and Connected Widgets.

Heading

Title is the widget's name, shown in its header. It starts as "Record Selector". Description is a switch, off to start. Turn it on and a text box appears, with the choice As A Tooltip or Below The Title; Below The Title is selected to start. For the example, the title is Pick a vendor.

Source

Source Select shows the table's name with the solution under it. Select it to open the picker: the current solution's tables first, and a back chevron to the list of every solution you can see, each opening into its tables. Two buttons sit under it. Filter narrows the records the selector offers, with the standard Filter control. Sort orders them. For the example, the source is the Vendors table, sorted by Vendor Name.

Selection Dropdown

A collapsed section with two controls. Fields to display opens the list of fields shown for each record in the dropdown. Allow users to create new records is a switch, on to start. With it on, the dropdown ends with an add line named for the table's record, "+ Add New Vendor" for the example. Turn it off to keep the list to picking only.

Tip: Turn Allow users to create new records off on a dashboard built for reading, such as the auditor's. The add line is otherwise the last item of every list.

Connected Widgets

A collapsed section that shows a count and the line "List of widgets that are using this Record Selector". The connection is made from the other widget's side: in a Record Details widget, Source lists this selector under Select Widget. For the example, the Record Details widget Selected vendor is connected.

The Selection Dropdown section with Fields to display and the Allow users to create new records switch, and the Connected Widgets count.

The Selection Dropdown section with Fields to display and the Allow users to create new records switch, and the Connected Widgets count.


The Style tab

Appearance sets the shape of the selector: Dropdown, a compact control that opens a list, or List, a panel that shows the records at once. The background is White, Neutral or Custom. For the example, the style is Dropdown on a white background.


Permissions

Solution Managers and members with Full Access add a Record Selector to a public dashboard and change its settings. The owner does so on a private dashboard. See Dashboard Settings. A viewer picks only among the records they can open; a selector on a restricted table lists fewer records for some members. A shared dashboard shows the selector read-only. See Public Dashboard Sharing.

Note: Two members can see two different lists in the same selector. A record one of them cannot open is left out for that member.


Using the widget

In View mode, the selector shows the first record of its list. Select it and the list opens with a Search box, the records, and the add line when adding is allowed. Pick a record and every connected widget refreshes to it at once. In View mode, hover over the widget to see a full-screen icon and a three-dot menu with Minimize and Export at its top right.

A second selector can cascade from the first, so a Contracts selector lists only the chosen vendor's contracts. For a dashboard where each member sees their own records, add a Filter condition on an Assigned To field with the value Current User. See Filter by Current User.

On a phone, the Record Selector is not shown in the mobile app. See Mobile Dashboard Widgets: Supported Features and Limitations Guide.

The selector in View mode with the list open: the Search box, the vendors and the + Add New Vendor line.

The selector in View mode with the list open: the Search box, the vendors and the + Add New Vendor line.


Editing a Record Selector widget

In Edit mode, hover over the widget. A strip appears in its header with Drag Widget, Move Up, Move Down, Edit and More Options. Select Edit to reopen the window; its footer now reads Cancel and Save Changes. Closing it after a change opens a prompt. It reads "Are you sure you want to exit without saving the changes you made?". Its buttons are Exit Without Saving and Save Changes.

The strip's More Options menu holds Minimize, Highlight Color, Duplicate Widget, Export, Delete Widget and Collapsed by Default. Duplicate Widget opens a dialog where you name the copy, which lands below the original. Delete Widget asks "Are you sure you want to delete the <name> widget?" with No, cancel and Yes, delete widget; a deleted widget does not go to the Recycle Bin. Deleting a selector leaves its connected widgets without a source. See Manage widgets on a dashboard. There is no Save button on the dashboard: Add Widget or Save Changes in the window is the only commit, and the dashboard autosaves.


Frequently asked questions

How do I make a page where I pick a customer and see only their information?

Add a Record Selector on the Customers table. Then, in each other widget's Source, choose the selector. Each one then shows the selected customer's data.

Can one Summary Card control other Summary Cards?

No. Use a Record Selector as the control and connect the cards to it. All of them update when the selection changes.

Can I filter a widget by what is selected in another widget?

Yes, when the other widget is a Record Selector. Pick it under the widget's Source.

Can viewers add a record from the selector?

Yes. Allow users to create new records is on to start, and the list ends with an add line. Turn the switch off to remove it.

Can I let someone pick a ZIP code?

Put the ZIP codes in a table and add a Record Selector on it in Dropdown style. The viewer searches and picks one, and the connected widgets follow.

Can each member see only their own records?

Yes. In the selector's Filter, add a condition on the Assigned To field with the value Current User. See Filter by Current User.

Last verified 30 Oct 2026.

Did this answer your question?