Skip to content

docs: clarify default/required filters only target visible dimensions#537

Merged
IrakliJani merged 1 commit intomainfrom
04-10-docs_clarify_default_required_filters_only_target_visible_dimensions
Apr 10, 2026
Merged

docs: clarify default/required filters only target visible dimensions#537
IrakliJani merged 1 commit intomainfrom
04-10-docs_clarify_default_required_filters_only_target_visible_dimensions

Conversation

@IrakliJani
Copy link
Copy Markdown
Contributor

This pull request adds documentation clarifying that default_filters and required_filters can only target dimensions, not metrics or hidden dimensions. The changes specify that these filters must target visible dimensions (including additional_dimensions) and that hidden dimensions with hidden: true are invalid targets that will cause compilation to fail.

Copy link
Copy Markdown
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 10, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@mintlify
Copy link
Copy Markdown
Contributor

mintlify bot commented Apr 10, 2026

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

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Apr 10, 2026, 4:45 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@IrakliJani IrakliJani marked this pull request as ready for review April 10, 2026 16:45
@IrakliJani IrakliJani merged commit fa8491b into main Apr 10, 2026
6 checks passed
IrakliJani added a commit to lightdash/lightdash that referenced this pull request Apr 10, 2026
closes: #21924  
closes: [PROD-6920](https://linear.app/lightdash/issue/PROD-6920/default-filters-on-hidden-dimensions-show-unknown-id-in-ui-but-still)  
  
docs: lightdash/mintlify-docs#537  
  
Description:

This PR adds validation to prevent hidden dimensions from being used in required/default filters. The explore compiler now throws a `CompileError` when hidden dimensions are referenced in `default_filters` or `required_filters`, suggesting the use of visible additional dimensions instead.
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