# Customize your list layouts

Edit your list layouts to customize how data is presented to your users.&#x20;

1. Select the list layout you want to edit
2. Select  <img src="/files/wdsZRdiRbfz1f8eZH138" alt="" data-size="line">**Edit Layout**

## Header

Choose a photo or color to be the header of your List Layout, add a title and subtext, choose where to align the title and where the toolbar appears on the page.

<figure><img src="/files/BoC775oOcz0JqKOANdEJ" alt="" width="563"><figcaption></figcaption></figure>

### Display

Change your layout type by selecting Display . Use a [Table, Cards, Boards, or One Record Only view. ](/stacker-astra/customize-layouts/list-layout/display-types.md)

## Roles

Decide the role(s) that can or cannot view a page.&#x20;

<figure><img src="/files/aZi1FUBI0x9NXHu1QeI6" alt="" width="375"><figcaption></figcaption></figure>

## [Filters](https://docs.stackerhq.com/stacker/security/data-filters/list-layout-filters)&#x20;

{% embed url="<https://vimeo.com/1010622719?share=copy>" %}

&#x20;You can apply filters to a list layout to limit which records will show in the layout based on details about the record or user types. You can limit a list layout to only show records that meet (or do not meet) specific conditions. Filters apply to all users including admins.

<figure><img src="/files/6dZrL4qwQFxZSpVlATuo" alt="" width="375"><figcaption></figcaption></figure>

* Filters can only use the 'AND' logic. If you have many conditions, then the records must meet all conditions.
* You can filter currency, percentage, roll-up, and formula fields using number operators: **=, <, <=, >, =>** and **≠.**
* Users must have 'read' permissions for the fields used in the filter.
* You can filter using relative date filters (eg. tomorrow, this week, last quarter).
* You can use filters along with duplicating layouts to create different layouts in your navigation.

## Sort

Sort changes the order of your records in the List layout. You can sort alphabetically by a field's name, with ascending or descending values. We recommend only sorting by text or number fields.

<figure><img src="/files/aI064Qa6rJZssqbEcDjU" alt="" width="368"><figcaption></figcaption></figure>

## Inline Filters

Inline filters let your app users filter list layout records based on specific fields that you choose.&#x20;

<figure><img src="/files/3PG1feUgcXowdmW9aWSF" alt=""><figcaption></figcaption></figure>

Select **Inline filters** and choose between **Quick** or **Advanced** filters.&#x20;

**Advanced Filters**

* Allow users to choose which fields they filter by or choose the filter displayed for the user.
* Users can change operators in advanced filters.

**Quick Filters**

* Quick option for filtering data that does not have operators.
* Show all filters or choose which filters are displayed to the user.

<figure><img src="/files/fotIAfMusfelAUBWbC1L" alt="" width="346"><figcaption></figcaption></figure>

## Inline Sorting

Allow end users to choose how they sort by enabling "Inline sorting".

<figure><img src="/files/spnWx4iUkXirTfj4GmFc" alt="" width="563"><figcaption></figcaption></figure>

## Advanced Settings

#### Advanced options: allow users to download data&#x20;

Toggling this setting on allows end users to download the list layout to a CSV. Only fields shown on the layout will download.&#x20;

{% hint style="warning" %}
When using the spacious header, it is not possible to show the download button to end users
{% endhint %}

#### Duplicating list layouts

Use the<img src="/files/mehujy0WSKW7sK5VFERl" alt="" data-size="line">duplicate layout icon to duplicate a list layout to create multiple views of the same table.

1. Select the<img src="/files/mehujy0WSKW7sK5VFERl" alt="" data-size="line">duplicate layout icon
2. Give your new layout a name
3. Save

<figure><img src="/files/xbvyFDbvw6E7NjcaSt1H" alt="" width="375"><figcaption></figcaption></figure>

This will create a sub navigation item on your navigation.&#x20;

<figure><img src="/files/lDIA7yXI4sHnzrJhkynn" alt="" width="375"><figcaption></figcaption></figure>

#### Edit layout name

Select the three dots on the top right to edit the layout name.

<figure><img src="/files/GvqCOoVGLhAzQJT2BT1b" alt="" width="375"><figcaption></figcaption></figure>

#### Delete Layout

Delete your duplicated layout by selecting the three dots on the top right.&#x20;

<figure><img src="/files/nHlP7WvErG5ue5Ruy6AA" alt="" width="375"><figcaption></figcaption></figure>

## Content

Show all fields or choose fields to display, then toggle on the fields you want to display on your list layout. Use the <img src="/files/Fq5iRVCXY8AdvIillKGz" alt="" data-size="line"> pencil icon next to the field to change or hide the label, change the icon, or treat as a URL it is displayed or to add as a calculation above the table.&#x20;

Drag-and-drop fields to rearrange them on the layout.&#x20;

<figure><img src="/files/QxMTTuOtweG3UyICQtEw" alt="" width="375"><figcaption></figcaption></figure>

Calculations can show sums or averages of number fields or count how many records have an empty or not empty field.

<figure><img src="/files/4diEFLA8pciO4mABFX2s" alt="" width="563"><figcaption></figcaption></figure>

## Actions

Place action buttons on your list layouts allowing users to make record updates. Show actions as buttons or options in a drop down menu:&#x20;

<figure><img src="/files/c2JaY8I2QmQKkzwO3U3x" alt="" width="313"><figcaption></figcaption></figure>

First create an [Action button. ](/stacker-astra/ai-and-automations/action-buttons.md#create-action-buttons-in-list-layout-0-0)

#### Enable Action Buttons

1. Click the **Actions** tab
2. Select to show as **button** or in the **dropdown**
3. Toggle the button on
4. Use the eye icon to set conditional visibility&#x20;

## Actions -  System Buttons

The system buttons are the three dots that appear when hovering on a record and allow quick actions

1. Go to the List Layout
2. Click the three dots on the record
3. A drop down will appear&#x20;
4. Select what field you want to update or other action buttons

<figure><img src="/files/M1h9PhYjPieClVC7wPou" alt=""><figcaption></figcaption></figure>

Toggle the options that you want to appear on the system buttons menu and set up conditional visibility:

<figure><img src="/files/5GiLxBJOBjPo53oZuGei" alt="" width="371"><figcaption></figcaption></figure>

### Click Record Action

Choose what happens when a user clicks on a record by choosing from the **Click Record Action** dropdown.&#x20;

* Open Full Page
* Open as Preview
* Open in New Tab
* None&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stackerhq.com/stacker-astra/customize-layouts/list-layout/customize-your-list-layouts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
