All docs
/
Gen AI
/
Sandbox mode

Sandbox mode

Learn about sandbox mode, a playground to safely iterate + experiment with your data!

Overview

Sandbox mode is a special table mode that lets you safely build, test, and publish table configurations using a small subset of rows—without affecting your running workflow. With sandbox mode you can:

  • Test enrichments and integrations on a smaller dataset so you conserve credits and prevent accidental credit usage.
  • Hand-pick specific rows from your table to experiment with in your sandbox.
  • Keep your production table safe from changes while sandbox mode is active.
  • Review all changes before applying them to your full table.

Enabling sandbox mode

  1. Click Live in the top left → Sandbox mode.
    • If you do not see this menu, check that you are on a Pro or Enterprise Plan.
  2. After a few seconds, a new sandbox will be set up with sample rows, ready for you to make changes.
    • To discard changes and start a fresh copy of the sandbox: Click ⚙️Reset sandbox.
    • To turn off sandbox mode: Click Sandbox mode in the top left → Live. This will return you to your normal table and discard all unpublished changes in your sandbox.
Note: During sandbox mode, your regular table becomes read-only and cannot be updated directly. You can switch between your sandbox and the read-only production table using the tabs menu. All recurring sources (webhooks, signals, etc.) and scheduled runs will still run while sandbox mode is active.

Using sandbox mode

In sandbox mode, you can test formulas, waterfalls, and enrichments. Here are some other helpful notes:

  • You cannot add or edit sources in sandbox mode. To make these changes, first return to your normal table, then re-enable sandbox mode.
  • To prevent accidental updates, all outbound actions (actions that send data such as exporting or Write to Other Table) are automatically disabled in sandbox mode.
    • However, you can still manually run individual cells or columns if needed.

Adding data to the sandbox

When you start sandbox mode, the top 10 rows from your existing table will be duplicated as samples. Sandbox tables have a maximum of 50 rows.

To add additional rows to your sandbox:

  1. Click Add test data.
  2. Enter the number of rows and select your row selection mechanism.
    • If you select Top rows, it will add the next set of rows from the top of the current view in all data.
    • If you select Random set, it will randomly select rows from your All data tab.

To add specific rows:

  1. Navigate back to the All data tab using the top navigation.
  2. Select a set of rows in the table.
  3. Click Add X rows to test data.

Publishing sandbox changes

Viewing changes

Click Review changes to view a list of all structural column updates to your sandbox (compared to your regular table).

This includes:

  • Adding/deleting a new column.
  • Renaming a column name/description.
  • Update configurations to a formula, waterfall, or enrichment.

Notes on publishing changes:

  • Visual updates (such as pinned columns, column ordering, and colors) won't appear in the list, but will be applied when you publish.
  • Manually added rows and manual overrides to individual cell data will not be published.
  • Changes to a column that affect downstream columns are shown in a nested format to clearly indicate which other columns may be impacted.

Publishing changes

When you are ready to publish the changes in your sandbox to your regular table, you have two options:

  • Publish and don't Run will sync all your column configuration changes to all data but will not start a run for any of these columns. You would need to manually run them later.
  • Publish and run will sync all column configuration changes to all data and run all affected columns on all rows in the full table.

Explore other docs

Web scraping

Sumble integration

Validate whether a company uses specific technologies.

View article
Export

Microsoft Teams integration

Send messages to Microsoft Teams channels directly from Clay.

View article
Enrich

EmailBison integration

Import leads into campaigns directly from Clay, ensuring accurate and efficient campaign execution.

View article

Keyboard shortcuts

Work faster in Clay with keyboard shortcuts.

View article
Export

Salesforce SOQL

The Salesforce SOQL source enables you to import records from Salesforce by writing custom queries.

View article
Transform

Share workbooks and tables as templates

Share your Clay workbooks and tables.

View article
Enrich

Zerobounce integration overview

Email validation and deliverability tools boost inbox placement and marketing ROI.

View article

Other popular resources

Experts

Find a Clay Expert

Explore our network of Clay experts and agencies

View experts
Community

Join our slack community

Find help in our slack community, and support channels

Go to slack
Cohorts

Join a cohort, learn Clay fast!

The faster way to master Clay. Sign in if you're enrolled in a cohort (current or past) or apply to an upcoming one!

Learn more about cohorts