Skip to content

Fill gaps from assistant conversations: Insights filter scopes - #247

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/5a8f06e7
Open

mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/5a8f06e7

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

Summary

Clarify in the Insights doc that filters can be scoped per metric (inline) or applied to the whole report (global), so readers can filter one metric without affecting others.

Changes

  • docs/reports/insights.mdx: In Step 3 (Choose Filters), added a short breakdown of inline vs global filter scopes and a link to the general Filters section.

Context

Assistant conversations show users trying to apply a filter to only one metric in an Insights report and mistaking the report-level Filter button for a per-metric control. The distinction was already documented on the general Reports page but not surfaced from the Insights walkthrough.

@mintlify

mintlify Bot commented Sep 14, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
mixpanel-docs 🟢 Ready View Preview Sep 14, 2026, 4:15 PM

@mintlify
mintlify Bot requested a review from a team as a code owner September 14, 2026 16:12
@mintlify
mintlify Bot requested a review from argenisf September 14, 2026 16:12
@greptile-apps

greptile-apps Bot commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

RetriggerConfidence Score: 4/5

The documentation should be corrected before merging because its inline-filter workflow may not lead readers to the filter control.

Findings

  1. P1 Wrong inline filter control

Reviews (1) · Last reviewed commit: "docs: clarify per-metric vs global filte..."

Comment thread docs/reports/insights.mdx

Insights supports two filter scopes, and where you click determines which one you get:

- **Inline filter (per metric):** Click the event or behavior inside a specific metric card, then add the filter there. The filter applies only to that metric, so you can filter one metric while leaving other metrics in the same report unfiltered.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Wrong inline filter control

The existing Filters documentation says inline filters are added through the menu beside a query item. Directing readers to click the event or behavior may open its selector instead, leaving them unable to find the per-metric filter control.

Suggested change
- **Inline filter (per metric):** Click the event or behavior inside a specific metric card, then add the filter there. The filter applies only to that metric, so you can filter one metric while leaving other metrics in the same report unfiltered.
- **Inline filter (per metric):** Click the **** icon beside the event or behavior inside a specific metric card, then add the filter there. The filter applies only to that metric, so you can filter one metric while leaving other metrics in the same report unfiltered.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree, we could phrase it as "click on the options menu next to the event/metric (the ... icon beside it)" and then add the filter there".

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed — that wording is clearer and points readers to the actual control. I’d use:

  • Inline filter (per metric): Click the options menu next to the event or metric (the ... icon beside it), then add the filter there. The filter applies only to that metric, so you can filter one metric while leaving other metrics in the same report unfiltered.

Tip: You can customize Greptile's behavior for this repo with .greptile/rules.md and .greptile/config.json.

Comment thread docs/reports/insights.mdx

Insights supports two filter scopes, and where you click determines which one you get:

- **Inline filter (per metric):** Click the event or behavior inside a specific metric card, then add the filter there. The filter applies only to that metric, so you can filter one metric while leaving other metrics in the same report unfiltered.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree, we could phrase it as "click on the options menu next to the event/metric (the ... icon beside it)" and then add the filter there".

@saitanallensantiago26-beep

Copy link
Copy Markdown

Summary

Clarify in the Insights doc that filters can be scoped per metric (inline) or applied to the whole report (global), so readers can filter one metric without affecting others.

Changes

  • docs/reports/insights.mdx: In Step 3 (Choose Filters), added a short breakdown of inline vs global filter scopes and a link to the general Filters section.

Context

Assistant conversations show users trying to apply a filter to only one metric in an Insights report and mistaking the report-level Filter button for a per-metric control. The distinction was already documented on the general Reports page but not surfaced from the Insights walkthrough.

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.

2 participants