Change the layout of a List View

The list view is equivalent to a table in your spreadsheet and shows a summary of the records in a particular table.

When you create your first app, Stacker generates a default list view layout for you.

From there, you can completely change the configuration of your app by clicking on 'edit layout' at the bottom of the navigation bar.

Choose which Fields are Displayed

The first thing to decide when designing your list view layout is which fields are displayed to your users.

You can change which fields are shown on your list view summary by toggling them on/off in the edit bar. You can also reorder fields by clicking and dragging.

💡 The first field toggled on is the one that will appear as the record title.

Enabling fields in Stacker
To access more settings, hover your mouse over the field to reveal a pencil icon appear

Here you'll find options including: to edit or hide the label, treat the field value as a URL and display it as a button.

If you do not see a particular field in the list here, it's likely that it hasn't been enabled in the field settings for the table - you can select which fields are enabled in your field settings.

Changing your List Page Layout Settings

You can use the list page settings to customise how your data is presented. Here are some settings you might want to configure. 

Adjusting layout in Stacker

Filters

Filters can be used to limit the records that are displayed.

You can combine multiple conditions using AND logic, so that a particular record is only displayed if the record meets all of the criteria in the filter settings.

👉 Note: this will only affect which records are displayed on the list. This won't limit which records are accessible to users.

If you want to prevent users from seeing particular records, you should use Permissions and/or a Data Filter in your data source to reinforce this.

Sort

You can sort your records in either ascending or descending order for a particular field - for example, alphabetically by name, or highest to lowest by price.

Header

You can choose to add a header image and customize your header with a title and description.

Cover image

You can choose, if relevant, which field should be used as the cover image for each record in the list.

Display

You can choose how you would like your list to appear from six template views: 

  • Card
  • Rows
  • Board
  • Table
  • One record only
  • Inbox

Board display enables users to see records organised by a category. This could be status - such as 'Draft', 'Ready for sign-off', 'Active'.  

In board view, users can drag and drop records between segments to change the value of a field.

Board view

The 'One Record Only' display enables you to 'skip' the list view: your user will land directly in a detail view when they navigate to the table.

This display is best suited for situations in which a user should only see a specific record e.g. 'My Profile'.

The 'One Record Only' display will show the first record available where multiple records meet the conditions for the layout.

Roles

If you are using Roles , then you can choose which user types will have access to your list view by adjusting settings here.

Inline filters

You can enable inline filters on your display, meaning that your users can temporarily filter the records in the list view.

When enabled, all of the fields displayed in the list view that are suitable for inline filtering will appear at the top of the record list.

Next steps

Articles in this section