Documentation
Built for report designers who care about how their reports look — and want complete control over every detail.
What is SuperDatePicker?
SuperDatePicker is a free Power BI custom visual that replaces the built-in date slicer. It supports single date, date range, and relative date selection — with full control over how it looks in your report.
Dialog Mode
The picker opens in a Power BI dialog window when clicked. Good for reports where canvas space is tight. The calendar content — including the buttons — is fully customizable. Only the dialog's title bar and bottom bar are controlled by Power BI.
MiniCalendar Mode
MiniCalendar sits directly on the report canvas — no dialog, no constraints. You control everything: borders, background, and size.
Bad news first
Before you dive into configuration, it's only fair to point out one limitation that's beyond our control.
The dialog window can't be fully styled
When you click SuperDatePicker in a report, Power BI opens it in its own native dialog window. The title bar and bottom bar are fixed — they can't be customised. This is a Power BI platform constraint, not ours. Everything inside the calendar is fully customisable; only the dialog frame will always match Power BI's default look.
Workaround: MiniCalendar variant
If you need full control over the appearance, use the MiniCalendar variant. It renders directly on the report canvas without a dialog window — and is fully customizable including colors, layout, and borders.
Installation
SuperDatePicker ships as a single .pbiviz file. No AppSource account, no admin approval, no registration required.
Download the file
Head over to the Download page and grab the latest .pbiviz file. The version number is shown on the download page.
Open Power BI Desktop
Launch Power BI Desktop and open the report you want to add SuperDatePicker to — or create a new blank report.
Import the visual
In the Visualizations pane, click the three dots (…) → Import a visual from a file. Select the downloaded .pbiviz and confirm.
Add it to your canvas
The SuperDatePicker icon now appears in your Visualizations pane. Click it to place the visual on the canvas, then drag a Date or DateTime column into its field well.
Formatting & Configuration
SuperDatePicker offers over 90 configuration options grouped into logical sections in the Power BI Format pane. Below is an overview of each category.
Click any calendar area to filter the options list.
Theme Transfer
SuperDatePicker's entire configuration can be exported as a compact JSON string. Copy a finished setup to another visual, share a theme with a colleague, or build a library of brand-approved configurations — all in a few clicks.
Export
Open the Format pane, go to Advanced → Configuration → Export. SuperDatePicker generates a JSON string with all your current settings. Copy it to the clipboard or save it as a file.
Import
Open the Format pane, go to Advanced → Configuration → Import. Paste the JSON string and confirm. All settings are applied instantly — no manual tweaking required.
Share
The exported JSON is plain text. Email it, share it in Teams, or store it on a shared drive. Anyone with SuperDatePicker installed can import it in seconds.
Pro tip: batch update
Need to apply new brand colors to 10 visuals at once? Export the configuration from one styled visual, then import it into each of the others. What would take an hour is done in minutes.
Localization
SuperDatePicker adapts to the language your users have set in Power BI — automatically, with nothing to configure.
Calendar follows Power BI's language
Month names, day abbreviations, and the first day of the week all adapt to the interface language the user has set in Power BI. This works the same way as any other custom visual — no setup required.
Format pane available in English and Czech
The formatting options in the Power BI Format pane are available in English and Czech. The calendar itself displays in whatever language Power BI is running in, independently of the pane language.
Want to add your language?
We welcome contributions for additional languages. Instructions are in the readme on GitHub. Power BI supports dozens of interface languages — the more we cover, the more teams can use SuperDatePicker comfortably.
Troubleshooting
Running into an issue? Below are the most common problems and their solutions.
The visual shows a blank white box
This usually means no Date field has been connected to the visual. Drag a Date or DateTime column from your data model to the visual's field well.
My configuration changes aren't saving
Power BI requires you to click outside the Format pane or save the report after making changes. If changes still don't persist, check that you are not in read-only (published report) mode.
The dialog opens but the calendar is empty
Ensure the field connected to SuperDatePicker is of type Date or DateTime. Whole number columns or text columns formatted as dates are not supported.
Imported JSON configuration is not being applied
Make sure the JSON is valid and was exported from a recent version of SuperDatePicker. Configuration files from significantly older versions may not be fully compatible. Check the changelog on GitHub if you're unsure.
The visual is not showing up after import
Power BI sometimes requires a restart after importing a new custom visual. Save your report, close Power BI Desktop, reopen it, and try again.