---
title: "Clean Slate Environments"
slug: "clean-slate-environments"
updated: 2026-02-23T20:04:26Z
published: 2026-02-23T20:04:26Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.technolutions.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Clean Slate Environments

**Clean Slate** environments are a type of training database that come from one of three source types:

- **Model environments:**Blank, save for basic data structures that depend on lifecycle (that is, Admissions, Student Success, or Advancement).
- **Showcase environments:**A database loaded with examples of Slate functionality. You can import many of these objects into your test or production database using the [Suitcase](/v1/docs/suitcase-briefcase) tool.
- **Preferred Partner environments:**These are special-purpose databases for our [Preferred Partners](https://technolutions.com/preferred-partners), provisioned as part of events surrounding [Slate Summit](https://technolutions.com/slatesummit).

When you’re in a Clean Slate database, this banner appears at the top of every page:

![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/clean_slate_banner.png)

## Model Clean Slate environments

These minimalist databases contain the bare minimum: a single test person record, basic fields, decision codes, et cetera.

Your production database was likely provisioned from a model database similar to these options.

You can use this database for training purposes. New Slate users can practice without fear of impacting production data or accidentally sending communications.

## Showcase Clean Slate environments

Clean Slate a little *too*clean? **Showcase**environments are a great way to learn Slate best practices by example.

[Showcase environments](/v1/docs/showcase-environments), which come in Admissions, Student Success, and Advancement flavors, are pre-loaded with sample data and common use cases.

You can use [Suitcase Import](/v1/docs/suitcase) to make a copy of many of the Showcase environment’s data objects and bring them into your production or test environment.

## Provisioning a Clean Slate environment

Note that if you already have a Clean Slate environment, provisioning a new one erases all in-progress work in the existing Clean Slate environment. Proceed with provisioning only if there is nothing in Clean Slate left to be migrated to production.

> [!CAUTION]
> 🔔 Once erased, there is **no way to recover a previous version**of Clean Slate.

You should also consult with your Slate Administrators or other members of your Slate team before requesting a refresh with an active Clean Slate database. Communication is key: if you request a refresh of your Clean Slate environment,**it will refresh for everyone**.

To provision a Clean Slate environment:

1. In a production environment, select **Database.**
2. In the Auditing section, select **Test & Other Environments.**
3. Take note of the **Status** of your institution's Clean Slate environment:
  - **Active:**A Clean Slate environment has already been provisioned for your institution and is in use.
  - **Not Provisioned:** Your institution has not provisioned a Clean Slate environment.
  - **Expired:**A Clean Slate environment was provisioned for your institution but has yet to be accessed in the past 30 days. [![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/clean slate screenshot.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/active_clean_slate_instance.png)

#### If your Clean Slate is active

1. Select the arrow beside the **Launch Environment**button**.**
2. Confirm with your team that ***no one is using the Active Clean Slate***.
3. Select **Request Refresh**to generate a new Clean Slate.

![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/request refresh.png)

#### If your Clean Slate is Not Provisioned or Expired

If your Clean Slate is **Not Provisioned** or **Expired**:

1. Click **Provision**. ![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/clean slate provision(3).png)
2. From the Source list, select the appropriate **Model** or **Showcase** environment.
3. Select at least one Slate user as **Initial Administrator(s).**Only administrators can provide new users with access to the Clean Slate environment.
4. Add a **Memo** if desired. The memo will be displayed to users prior to requesting a refresh of the environment and may be used to provide details of intended use.
5. Click **Provision.**

[![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/provision clean slate(1).png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/provision_clean_slate_settings.png)

> [!WARNING]
> 📝 Provisioning or refreshing a Clean Slate environment may take up to three hours.

To access your new Clean Slate environment:

- Select the **endpoint URL**, or
- Select **Launch Environment**

> [!TIP]
> ✨ Bookmark your Clean Slate environment's URL for easy access, especially if your team is involved in a Fundamentals course.

## Adding user accounts to Clean Slate environments

If users other than the initial administrator(s) need access to the Clean Slate environment, you can add those accounts to Clean Slate directly.

There are two ways to add user accounts to Clean Slate: manually, or in bulk with Upload Dataset.

### Option 1: Manually add users to Clean Slate

This option has you manually recreating accounts in the Clean Slate environment. This is the fastest method for a small number of users.

To manually recreate user accounts in Clean Slate:

1. Launch your Clean Slate environment.
2. From the main navigation, select **Database.**Under Users & Access, select **User Permissions.**
3. Click **New User.**
4. Configure the user's account as you did in the production environment.

### Option 2: Add new users to Clean Slate with Upload Dataset

Using a query in your production environment and Upload Dataset in Clean Slate, you can move a large number of user accounts at once.

To add multiple accounts to Clean Slate with Upload Dataset:

#### Step 1: Export users from production

1. Launch Production Environment. From the main navigation, select **Queries/Reports** and build a new Query or Quick Query.
2. Query configurations:
  - **Type:**Configurable Joins
  - **Category:**Related
  - **Base:**User
3. Exports: *The following exports are required for user account creation:*
  - Username
  - First Name
  - Last Name
  - Email Address
4. Filters
  - Utilize the appropriate user-scoped Filters to produce a list of users to move to Clean Slate.
5. Once satisfied with the results, **Run**and **Export**the Query**.**

#### Step 2: Import new users to Clean Slate

1. Launch Clean Slate. From the main navigation, select **Database.**Under Import, select **Sources / Upload Dataset.**
2. Click **Upload Dataset.**
  - In the **File Format** dropdown, choose **New Spreadsheet/Data File**.
  - If desired, select a current Folder, or select **Other** to add a folder.
  - In the **Destination Scope** dropdown, choose **User**.
  - Add the file containing the new user information, then click **Upload**.
3. On the right, click **Build Import.**
4. From the list of Field Mappings, connect the source mappings to a destination mapping (including, at the least: User ID, First Name, Last Name, and Email Address).
5. On the right, click **Review & Run Import**.
6. Click **Run Import.**
7. From the main navigation, select **Database.**Under Import, select **Force Process Import.**Click **Back**in your browser and return to **Sources / Upload Dataset**. Verify that your list of users has imported.
8. From the main navigation, select **Database.**Under Users & Access, select **User Permissions.**
9. On the right, click **Inactive Users**.
10. Select the new user account or accounts from the list and click **Edit User.**
11. Select **Enable account for access.** Click **Save.**