docs(audiences): add Trial plan segment limit and CSV no-row-cap to plan availability#1549
Merged
george-dilthey merged 2 commits intoJul 14, 2026
Merged
Conversation
Trial workspaces can create up to 250 audience segments. This limit was not documented. Customer asked in Intercom #215475060233877 and support had to explain it manually. Verified: TRIAL_MAX_SEGMENTS = 250 at audiences-plan-limits.service.ts:42.
…vailability
- Trial workspaces can create up to 250 audience segments
- CSV imports are not row-capped on any plan
Both confirmed by code (audiences-plan-limits.service.ts, audience-record-limit.service.ts)
and Slack ("unlimited CPJ and CSV imports"). Source: Intercom #215475060233877.
Contributor
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
Added two pieces of plan-availability information to
docs/audiences.md:Both facts are appended to the existing Plan availability paragraph on line 9, in one sentence.
Why
Intercom conversation #215475060233877: a Trial-plan customer (james park) asked "how many can upload audience companies rows in trial plan? I already have a above 10,000 rows buyer list." Fin escalated because the docs said nothing about row caps or segment limits for Trial — only that CRM/DW sync requires Growth. Support agent Adhvita replied: "Trial supports up to 250 audience segments (that's the number of audiences you can build, not a limit on rows within one). On the trial plan you can upload company lists into Audiences via CSV with no separate row cap on imports, so your 10,000+ rows from Apollo will go in without issue."
Neither of those facts appeared in the docs, so Fin had no basis to answer and escalated.
The deduplication-scope question (dedup doesn't reach regular Clay tables) from the same conversation is already covered by open PR #1547, which adds a dedicated FAQ — that is not repeated here.
I evaluated all four open PRs on
docs/audiences.mdflagged by pre_pr_check:Source link(s)
clay-base/libs/shared/src/feature-flags/featureFlags.ts:323(GLOBAL_FEATURE_FLAG_DEFAULTSsetsAudienceSegmentLimit: 250); Trial plan (clay-base/libs/shared/src/billing/plan.ts:101-121) does not override, so it inherits 250; enforced atclay-base/apps/api/v3/audiences/services/audience-segment-limit.service.ts:26-39clay-base/apps/api/v3/audiences/services/audience-record-limit.service.ts:160-166—getCountedImportBigSourcereturnsnullforAudienceImportSourceType.Csv, meaning CSV is never counted against the record limit; Slack #workstream-pricing (2026-06-09): "All plans with access will have unlimited CPJ and CSV imports"Uncertainties
None. Both claims are hard-coded and confirmed by the verifier with no feature flags or plan-tier gates.
Related observations
PR #1547 (open,
docsbot/doc-1138-intercom-tag-0714-ef13917e) adds the dedup-scope FAQ from the same conversation. PR #1528, PR #1507, PR #1485 also touchdocs/audiences.mdon unrelated topics. All four will need to reconcile with this PR at merge time — this PR only edits line 9 of the plan availability paragraph, which none of the other four touch.Closes DOC-1142