---
title: Configurations (admin)
slug: tv-toolbox/configurations-admin
createdAt: 2026-10-13T09:14:58.421Z
---

Set which sandboxes, cleanup methods, and defaults the Cleanup Sandbox tool offers, and how long cleanup history is kept.

## Prerequisites

- You have the **View Configurations** permission to see the settings, or **Manage Configurations** to change them. Both belong to the **Sandbox Tooling** permission resource.
- The app's database is initialized. If it isn't, a message tells you to go to **Configurations** to set it up.

## Steps

### Open the settings

1. In the left navigation, under **Administration**, click **Configurations**.
2. Click the **Sandbox Tooling** tab.
3. Find the **Cleanup Sandbox** panel. Without **Manage Configurations**, there is no **Save** button, so changes can't be saved.

<font color="#EF4444">TODO(user)\: screenshot of the Sandbox Tooling tab.</font>

### Set cleanup history retention

1. Under **Cleanup history TTL**, set **Time to live (TTL) for cleanup history** to a number of days from 1 to 365. The default is 365.
2. To let people delete history records older than the TTL, keep **Allow manual deletion of history records older than TTL** selected. It is selected by default. <font color="#EF4444">TODO(user)\: confirm where this deletion is done in the app.</font>

:::hint{type="info"}
Changes to the TTL aren't applied to history records that already exist.
:::

### Choose which sandboxes people can pick

1. Under **Sandboxes**, choose one:
   - **Show all sandboxes**.
   - **Show only sandboxes the user has access to**. This is the default.
2. To block sandboxes from cleanup, add them to **Blacklisted sandboxes**. They won't be available in the cleanup tool.

### Choose cleanup methods and defaults

1. Under **Cleanup methods**, in **Available cleanup methods**, select the methods people can choose: **User group(s)**, **Age**, **Keyword(s)**, and **Manual**.
2. In **Default selected cleanup method**, choose the method that's pre-selected.
3. Use the tabs below to set defaults for each method:
   - **User group(s)**: in **Allowed User group(s)**, choose the groups people can select. In **Default selected User group(s)**, choose the groups that are pre-selected. Default groups must also be allowed groups.
   - **Age**: set the default age and unit. The default is 1 month.
   - **Keyword(s)**: add the keywords that are pre-filled. Type a keyword and press **Enter**.

<font color="#EF4444">TODO(user)\: GIF of selecting methods and setting defaults.</font>

### Save

Click **Save**. A message confirms **Settings saved successfully**.

## Expected result

When you open Cleanup Sandbox and click **Start cleanup**, the **Method** list shows the methods you enabled, and the defaults you set are pre-filled.
