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 without using extra credits.
  • 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.
  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.
Credit-saving feature: When you publish, rows that were already run in sandbox mode are copied back to your production table with their results intact. This means you don't have to re-run those rows and spend credits again.

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.
  • Enrichment results from rows run in sandbox mode are copied to your production table on publish, so you don't need to re-run them.

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

Enrich

SE Ranking integration

Enrich your data with AI search visibility metrics, traffic estimates, ad spend data, and organic competitor information.

View article
Enrich

Using Clay in Microsoft 365 Copilot

Find people, enrich contacts, and draft personalized outreach — all within Microsoft 365 Copilot.

View article
Getting started

MCP troubleshooting and FAQs

Answering the most common questions regarding MCP.

View article
Enrich

Using Clay in Glean

Find people, enrich contacts, and draft personalized outreach — all within Glean Assistant.

View article
Getting started

Clay API & CLI

Access Clay's data and enrichments programmatically with the Clay CLI and Public API — no UI required.

View article
Signals & triggers

AgentMail integration

Use AgentMail with Clay to capture inbound emails as table rows in real time and draft or send replies directly from your workflows.

View article
Find

Magellan Data integration

Discover corporate ownership and private equity relationships.

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