Credit usage

Credit usage dashboard

To check the credit usage in your workspace:

1. Click your account name in the corner.
2. Go to Settings and then Usage in the sidebar.
3. Within Workbooks, you can view folders, workbooks, and tables sorted by their usage.

Sort the content by Name (alphabetically) or by number of Credits used by clicking the column titles. You can Export this content as a CSV.

Filter and sort credit usage

The columns in this view display:

• Name: The folder, workbook, or table. Click the dropdown next to a folder or workbook to see the contents.
• Usage: Marked as Recurring when it contains recurring credit usage (e.g., scheduled runs or signals).
• Owner: The person who owns the project.
• Credits used: The amount of credits used for this period.

Filter any of the content on this page by:

1. When the credits were used.
2. Owner of the project.
3. Specific integrations being used.

Understanding table-specific credit usage

For deeper insights into credit spend within a specific table, you can access the table credit usage dashboard. This gives you realtime data on when and how credits were spent within that table.

How to access the table dashboard:

From a table:

• Click the Credit usage button within the Credits popover and select Table credit usage.
• Click the Table History button in the lower right corner of your table.

From the workspace credit dashboard:

• Click the chart button next to any table's name to open its table-level dashboard.

Dashboard views:

The table credit dashboard offers three ways to analyze your credit spend:

Time view: See a time series graph of your table's credit spend over time. You can:

• Choose your time range
• Use Aggregate by to bucket spend by hour, day, week, or month — the units on offer depend on the range you've selected, and Clay starts you on hourly buckets for ranges under a day. This picker belongs to the table-level view; the workspace-level charts choose their interval for you
• Break down each bar by action type to see what consumed credits

Column view: See your spend broken down by each column in your table, helping you identify which enrichments are using the most credits.

Run view: See spend events grouped by run, where a run could be:

• A manual action (clicking the Run button on a column)
• An automated action (scheduled source import or auto-update)

All views allow you to download the data as a CSV for further analysis.

Balance and spend over time

The Overview tab charts your workspace's credit history as a time series, so you can watch your balance draw down and see exactly when credits were spent instead of reading a single point-in-time number. Use the When dropdown above the chart to set the period, then switch between the two views:

• Balance — your workspace's total data credit balance across the selected period, plotted as an area chart.
• Spend breakdown — one bar per interval showing the credits spent in that interval, with the exact figure for the whole period shown above the chart as total credits spent.

Hover any point or bar to see its timestamp and exact credit value.

Choosing a time range

The When dropdown offers This week, This month, Last week, Last month, and Custom range. This month is selected by default, and Custom range can reach back as far as December 18, 2024.

The interval scales automatically to the range you pick — there's no separate control for it:

• Ranges shorter than 6 hours are bucketed by minute.
• Ranges shorter than 7 days are bucketed by hour.
• Ranges of 7 days or longer are bucketed by day.

If your workspace has no credit activity in the period you select, the chart is replaced with No balance data for the selected time range or No usage data for the selected time range.

Drilling into a spike

On Spend breakdown, click and drag horizontally across the chart to highlight a region. Clay narrows the When range to the region you selected and rebuckets at the finer interval that shorter duration calls for, so you can go from a daily view down to the hours — and then the minutes — behind a spike. Dragging isn't available on Balance.

Credit usage breakdown

The credit usage dashboard is organized into tabs, each covering a different slice of your workspace spend. Use the When dropdown and Apply filters to scope each tab to a specific time period. The Overview tab is the exception: it has no filter bar, since its balances are always current and its chart carries its own When dropdown.

• Overview — shows what your workspace has left rather than a breakdown of what it spent. Below the balance chart, a Workspace balances section gives you a meter for Data credits, one for Actions, and one for each prepaid allowance package your workspace has. Manage plan sits at the top of that section, alongside Add one-time data credits on plans that can buy top-ups.
• Workbooks — shows credit spend broken down by folder, workbook, and table. Click the dropdown next to any folder or workbook to drill into its contents. Sort by Name or Credits used. Click Export to download a CSV for offline analysis.
• Integrations — shows credit spend grouped by integration across your entire workspace, so you can quickly see which data providers are consuming the most credits. Sort by Name or Credits used. Click Export to download a CSV.
• Signals — shows credit spend broken down by individual signal. A totals row (All Signals) appears at the top, followed by a per-signal breakdown of Credits used and Actions used.
• MCP — shows programmatic spend from team members who access Clay through ChatGPT or Claude, broken down by user. Spend that can't be attributed to a specific user appears as Unattributed. For per-user credit limits and live usage tracking, see Settings → MCP users.
• API — shows programmatic spend generated through Clay's API and Exportly, broken down by user. Like MCP, unattributable spend appears as Unattributed.

Allowance packages

Some Enterprise workspaces are granted a prepaid allowance on top of their data credits — a pool of enrichment units that gets spent before any data credits are charged. If your workspace has one, it appears as its own meter on the Overview tab under Allowance packages. The section is hidden for workspaces that have never been granted an allowance.

The Companies, people, and jobs allowance meter shows:

• Available allowance: How many units are left in the current billing period.
• Total allowance: How many units your workspace was granted for the period.
• A progress bar of available units against the granted total, which changes color as the balance gets low.

How the allowance is counted

• Each companies, people, and jobs enrichment that would normally cost data credits draws down 1 unit instead — one unit per enrichment per record, no matter how many data credits that enrichment would otherwise have cost.
• Actions are unaffected. An allowance draw covers the data credit side of an enrichment only, so the run still consumes 1 action per record as usual.
• The allowance doesn't roll over. It resets to your granted total when your billing period renews, so unused units don't accumulate.
• Nothing needs to be switched on or off. Tracking is automatic, and the meter updates as enrichments run.

When the allowance runs low

Clay warns you on the Overview tab before the pool is empty. At 15% or less remaining, you'll see Your Companies, people, and jobs allowance is running low. Once the balance hits 0, that becomes Your Companies, people, and jobs allowance is used up.

Running out doesn't interrupt anything. The affected enrichments cut over to standard data credit pricing automatically and keep running against your regular data credit balance.

Credit estimates before running

Clay provides transparent cost estimates before you run enrichments or actions in your tables. This helps you understand and manage your credit usage.

Run cost breakdown

When you run a column that has dependent columns (downstream enrichments that will automatically trigger), you'll see:

• Total estimated credits for the run.
• Breakdown by column showing which columns will run and their individual costs.
• Number of rows that will be affected.

This estimate appears for any column run that would trigger dependent enrichment columns, including runs initiated by:

• Manual column runs
• Changes to data sources
• Adding new rows

Expensive run warnings

Clay shows a warning when you're about to initiate a run that will use a significant portion of your workspace's monthly credit budget. The warning appears when both of the following are true:

• The run would cost at least 5% of your monthly credit budget.
• The run would cost more than 500 credits.

Because both conditions have to be met, Clay never warns on runs of 500 credits or fewer — even on a small plan where that would be a large share of your budget. This helps prevent accidental large credit expenditures.

Import warnings

When you import data to existing tables (via Copy Paste from URLs, adding a source, or CSV upload), you'll see a confirmation modal if the import would trigger downstream actions. This modal:

• Warns you about potential credit usage from auto-running enrichments
• Shows estimated credit impact
• Gives you the option to toggle auto-run off for the table before importing

This prevents unexpected credit usage when you add new data to tables with existing enrichment workflows.

FAQs

Does allowance usage show up in the credit spend breakdown?

No. The Workbooks, Integrations, Signals, MCP, and API tabs count data credits and actions only — allowance units are metered separately and appear on the Overview tab. An enrichment covered by your allowance shows no data credit spend against the workbook that ran it.

What happens to my allowance if an enrichment fails?

If a run fails and qualifies for a refund, the allowance unit is returned to your balance the same way data credits would be. Because a single unit covers the enrichment in full, there are no partial per-result charges or refunds layered on top of it.

Are all companies, people, and jobs enrichments covered?

Nearly all of them. Two are outside the program and always bill data credits at standard rates: company technographics, and the recent-posts lookup for a person. One search-based enrichment, Find & Enrich Person from Google Search, draws a unit and still bills a reduced data credit rate rather than being waived entirely.

Why don't I see an allowance meter?

Allowances are granted as an add-on to an Enterprise plan. If your workspace doesn't have one, the Allowance packages section doesn't appear at all — reach out to your Growth Strategist if you think it should.