Date filters
Date filters let you narrow any report — and the customer list — to customers whose lifecycle dates fall inside a specific calendar window. They answer questions the standard filters can't, like "how did the customers who started paying in H1 2026 actually perform?"
They are the absolute counterpart to the Customer age filter. Customer age is relative and rolling ("0–6 months old", recalculated every day). A date filter is absolute and pinned — "started paying between 1 January and 30 June 2026" means the same thing whenever you run it, which is what you want for a cohort you'll come back to.
The four dates
Each one maps to a date GrowPanel stores on every customer:
- Lead created at — when the customer first appeared in your data, whether or not they ever paid. This is the closest thing to a signup date.
- Paid since — when recurring revenue first started for that customer. Customers who never converted have no value here, so filtering on it automatically excludes leads and unconverted trials.
- Canceled — when the customer's subscription ended. Only set for customers who have actually churned.
- Trial end date — when the trial ends (or ended). Useful for finding trials that are about to expire.
Lead created at and Paid since are not the same date for anyone who trialled first. If you're asking a revenue question — churn, retention, expansion of a cohort — Paid since is almost always the one you want, because it's the date the money started. Use Lead created at for funnel questions.
Choosing a window
Add a date filter the same way as any other: Filter → Lead created at / Paid since / Canceled / Trial end date. Each supports four operators:
| Operator | Meaning |
|---|---|
| is | that exact day |
| on or after | from that day onwards |
| on or before | up to and including that day |
| between | both dates included |
There's also has any value / has no value, which is how you ask "has this customer ever cancelled?" without caring when. For example, Canceled has no value gives you every customer who has never churned.
All bounds are inclusive. "Paid since on or before 30 June 2026" includes everyone who started paying on 30 June.
Examples
- New-customer churn — Paid since on or after 1 January 2026, then open Logo churn or Retention. You now see churn for the 2026 intake only, with older customers excluded entirely.
- Trials expiring this week — on the customer list, Trial end date between today and next Friday.
- A clean cancellation cohort — Canceled between 1 April and 30 June 2026 on the customer list, then export to CSV for a win-back campaign.
- Never-churned customers — Canceled has no value, combined with a plan or region filter.
Date filters combine with every other filter and with saved segments, so you can save "2026 intake, monthly plans, EU" as a segment and reuse it across reports.
Sharing a filtered view
Date filters live in the URL, so any filtered report is a shareable link — send a colleague the exact cohort you're looking at and they'll see the same thing.
The same filters are available on the REST API, the CLI, the SDKs and the MCP server. See the API reference for the parameter names and range syntax.
