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 the Sandbox mode button in the toolbar.
    • If you do not see this button, 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 Exit sandbox in the toolbar. 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

Getting started

Table versions

Table versioning lets you track structural changes to your Clay tables over time and restore previous configurations when needed.

View article
Getting started

Table alerts

Table alerts automatically monitor your Clay tables and notify you when something needs attention.

View article
Export

Salesforce integration FAQs

Answering common questions about connecting and troubleshooting the Salesforce integration.

View article
Web scraping

Meer integration

Screen phone numbers against national do-not-call registries before initiating outbound calls.

View article
Settings & admin

Best practices for B2B email direct marketing

Conduct effective outbound email outreach whilst also lowering the risk of challenges

View article
Settings & admin

Do Not Contact (DNC) compliance & best practices

Information about DNC compliance and best practices.

View article
Web scraping

BuyerCaddy integration

Enrich company tech stacks, verify technology usage, and more!

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!

Learn more about cohorts
Talents

Hire GTME Talent

Find and connect with GTM talent who've demonstrated expertise in building advanced workflows

Explore GTME talents