Skip to content
databrushDocs
  • OverviewDatabrush’s churn and retention analysis for your Supabase database, in the app and over MCP.
  • QuickstartConnect Supabase, choose your database and confirm the setup to publish your first analysis.
  • Supabase integrationHow Databrush connects to Supabase, what it reads and keeps, and how to revoke its access.
  • Connect your agentConnect Databrush to Claude, Claude Code, ChatGPT, Codex or another agent over MCP.
  • Tool referenceEvery tool Databrush’s MCP server offers, what it does, and who can use it.
  • How it worksHow Databrush analyzes your data, what Home shows, and how sure each finding is.
  • DefinitionsCustomers, who is left out, actions, churn and the dormant window, and how to change them.
  • Security & dataHow Databrush protects your database, your customers’ details and your account.
Connect Supabase
Definitions

Product

Definitions

Every Databrush number follows a few definitions. Databrush proposes them from your database at setup, you confirm them, and you can change them later in Settings.

On this page

Customers

A customer is whoever pays for or uses your product: an organization, a team, an account or a single user, whichever fits how your product works. Databrush proposes it from your schema, and every count and rate is per customer.

Who is left out

Some records shouldn’t count, such as your own team’s accounts or test accounts. You choose who is left out in Settings › Customers. When Databrush spots likely ones, it proposes leaving them out in Waiting for you, and you accept or dismiss each proposal.

Actions and activity

Actions are the things customers do in your product, read from your tables. You choose which actions count as activity, and those decide whether a customer is active. When a new kind of action appears in your data, Databrush asks in Waiting for you whether to keep counting it. Change the list in Settings › Actions.

Churn and dormant customers

Home’s Overview counts customers in four groups:

GroupMeaning
ActiveNot dormant, cancelling or churned.
DormantA paying customer with no activity for longer than the dormant window.
CancellingHas cancelled, but their plan hasn’t ended yet.
ChurnedHas left, by the churn definition you confirmed.

A customer’s record shows a more specific status, such as Gone quiet or Payment failing.

The churn definition says which values in your database mean a customer has cancelled or left. The dormant window is how many days without activity make a paying customer dormant. Change both in Settings › Churn definition.

Changing a definition

Owners and admins can change any definition. Before you save, Databrush previews the change: which customers would change status, or whether an edit to the actions changes what counts as activity.

Questions? Email support@databrush.ai.