Skip to content

docs(audiences): add FAQ for deleting custom fields from Audiences - #2385

Merged
george-dilthey merged 1 commit into
mainfrom
docsbot/doc-2154-intercom-tag-0828-9c692101
Aug 28, 2026
Merged

docs(audiences): add FAQ for deleting custom fields from Audiences#2385
george-dilthey merged 1 commit into
mainfrom
docsbot/doc-2154-intercom-tag-0828-9c692101

Conversation

@george-dilthey

Copy link
Copy Markdown
Contributor

What changed

Added a new FAQ entry — "How do I delete a custom field from Audiences?" — to docs/audiences.md, inserted immediately after the existing "How do I create a custom Audience field" FAQ. The new FAQ explains that the Audiences column header only shows Hide (not "Delete column" like in regular tables), and that field deletion is done through Data Hub → Fields tab → click the field → Delete field.

Why

Intercom conversation #215475688380546 (Lee Napierkowski, Branch): the customer asked "how do I remove columns that I created?" in the Audiences (People/Companies) view. Fin gave instructions for regular Clay tables (click column header → Delete column), which don't apply in Audiences — the customer kept replying "I only see hide." The ticket escalated to a human. The customer eventually found the answer themselves but said "Fix your AI" — indicating the docs did not give Fin enough context to answer correctly.

The root cause: docs/audiences.md had a FAQ on creating custom Audience fields but no corresponding FAQ for deleting them. The table column FAQ (docs/table-columns-overview.md) describes the standard "click column header → Delete column" path that doesn't exist in Audiences.

Source link(s)

  • Intercom conversation: https://app.intercom.com/a/inbox/w28k1kwz/inbox/conversation/215475688380546
  • Verifier confirmed (PASS): AudiencesHeaderCell.tsx:17type AudienceHeaderAction = 'hide' (only Hide is available in the Audiences column dropdown, no Delete); deletion lives in AudiencesDataHealthSidebar/AudiencesFieldSidebar/AudiencesFieldDeleteButton.tsx — the sidebar opened from Data Hub → Fields
  • Verifier Slack context: #team-audiences thread (2026-07-28) and #proj-audiences-core-product thread (2026-07-30) both document the same UX confusion about Audiences column deletion not being accessible from the column header

Uncertainties

None. The code unambiguously shows: (1) column header in Audiences only has Hide, (2) Delete field lives in the Data Hub field sidebar.

Related observations

Closes DOC-2154

Adds a FAQ entry explaining that the column header in Audiences only shows
Hide (not Delete column), and that field deletion is done through
Data Hub → Fields tab → click field → Delete field sidebar button.

Closes DOC-2154
@linear-code

linear-code Bot commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

DOC-2154

@george-dilthey
george-dilthey marked this pull request as ready for review August 28, 2026 16:44
@george-dilthey
george-dilthey merged commit 0fbe40f into main Aug 28, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant