# Disk Table Configuration

## Columns

You can configure which columns are shown by the disk table widget by setting the `columns` setting:

```toml
[disk]
# Pick which columns you want to use in any order.
columns = ["Disk", "Mount", "Used", "Free", "Total", "Used%", "R/s", "W/s"]
```

## Default Sort Order

You can customize the default sort order (by default, it sorts by disk name). For example, to sort by the read rate:

```toml
[disk]
default_sort = "R/s"
```

You can use any valid [column](#columns) name here (e.g. "Disk", "Mount", etc.). Note that if you put a column name that
is not actually used, the default sort will just be the first column shown.

## Show Unmounted Devices (Linux only)

By default, only mounted devices are shown. To also show unmounted devices on Linux, enable `include_unmounted`:

```toml
[disk]
include_unmounted = true
```

Unmounted devices show I/O activity but have no used/free space (those require a live mount), so those
columns appear as `N/A`. Pseudo-devices (`loop*`, `ram*`, `zram*`) are skipped, and you can hide other
noisy devices with the [name filter](#filtering-entries).

## Filtering Entries

You can filter out what entries to show by configuring `[disk.name_filter]` and `[disk.mount_filter]` to filter by name and mount point respectively. In particular,
you can set a list of things to filter with by setting `list`, and configure how that list
is processed with the other options.

For example, consider a disk widget showing these entries:

![Disk no filter](../../assets/screenshots/config/disk-filtering/disk_no_filter.webp)

If we wanted to ignoring any entry with a name that matches `/dev/sda`:

```toml
[disk.name_filter]
# Whether to ignore any matches. Defaults to true.
is_list_ignored = true

# A list of filters to try and match.
list = ["/dev/sda"]

# Whether to use regex. Defaults to false.
regex = true

# Whether to be case-sensitive. Defaults to false.
case_sensitive = false

# Whether to require matching the whole word. Defaults to false.
whole_word = false
```

This would give us:

![Disk widget with just disk name filter](../../assets/screenshots/config/disk-filtering/disk_name_filter.webp)

We can also combine both the name filter and mount filter. For example:

```toml
[disk.name_filter]
is_list_ignored = false
list = ["/dev/sda"]
regex = true
case_sensitive = false
whole_word = false

[disk.mount_filter]
is_list_ignored = true
list = ["/mnt/.*", "/"]
regex = true
case_sensitive = false
whole_word = true
```

This gives us:

![Disk widget with disk name and mount filter](../../assets/screenshots/config/disk-filtering/disk_name_mount_filter.webp)
