ZoomCharts Documentation

Using License Key and Hash for Drill Down Visuals

To unlock and use the paid features of ZoomCharts Drill Down Visuals in Power BI, you must provide a valid License Key and Hash within the visual’s License Settings.

These credentials verify your subscription and enable full functionality of the visuals.

Where to find your License Key and Hash

Your License Key and Hash are generated automatically when you purchase a license, apply for developer license or start a trial.

You can access them in two ways:

• In the confirmation email sent after your purchase or trial activation
• By logging into your ZoomCharts account

1. Download license as a .json file (custom theme)
2. Or access license key and hash separately

How licensing works

Before applying the license, it is important to understand how licensing functions. The License Key and Hash are applied at the visual level, not globally by default. License credentials are stored within the visual’s formatting settings . When your license is renewed, you will receive a new License Key and Hash, and the old values must be updated.

There are three supported approaches how you can apply and manage your license:

1. Individual visual level
2. Report level (custom theme)
3. Organization level (recommended)

Each method is described in detail below.

1. Applying a license at the individual visual level

This is the most direct method and is typically used when working with a small number of visuals or when testing.

Step-by-step instructions

1. Open your Power BI report
2. Add a Drill Down Visual to the report canvas
3. Assign data fields to create a chart
4. Open the Format pane (visual formatting options)
5. Locate and enable the Paid Features toggle
6. Expand the License Settings section
7. Copy and Paste License Key and Hash into the corresponding fields in Power BI
8. Repeat the process for each additional visual

If license is applied correctly, you will see a green check mark in the info window.

Additional guidance

• Licensing is applied per visual instance, so even identical visuals require credentials. Instead of configuring each visual manually, copy and paste an already licensed visual. The License Key and Hash are included in the visual configuration and will be carried over.
• If the visual still shows a license error after entering credentials:
  1. Check for accidental spaces when copying/pasting
  2. Open License Settings field
  3. Use the “Reset to default” option and re-enter the values
  

2. Applying a license at the report level (custom theme)

To simplify license management, you can apply credentials across the entire report using a custom theme file (.json).

This method ensures that all Drill Down Visuals in the report automatically receive the license, and you need to apply the license only once per report.

Step-by-step instructions

1. Log in to your ZoomCharts account
2. Locate the Download custom theme
3. Download the theme file (.json) to your computer
4. Open your Power BI report
5. Go to the View tab in the top ribbon
6. Expand the theme options
7. Click Browse for themes
8. Select and upload the downloaded .json file
9. Once applied, the License Key and Hash are automatically configured for the report
10. You can now add Drill Down Visuals without manually entering credentials

Important considerations

• The theme applies only to the current report. You must repeat this process for each new report you create. After license renewal, you need to download and apply a new theme file.

Tips and best practices

• Apply the theme early. Apply the theme before adding visuals to avoid conflicts or manual corrections.
• Avoid partial configuration issues. If you opened and interacted with License Settings before applying the theme, the automatic application may not work.
  To fix this:
  1. Open Format → License Settings
  2. Click on Reset to default
  3. Reapply the custom theme
  

3. Managing licenses at the organization level (recommended)

For teams and organizations, the most efficient approach is to manage licensing centrally using Power BI Organization Themes.

How it works:

• A Power BI administrator uploads the ZoomCharts license theme (.json) to the organization’s theme library
• The theme becomes available to all users in the organization
• Report developers can easily select and apply it without downloading or uploading files manually

Applying the theme

Even with organization-level themes, report creators still need to select and apply the theme when creating a report as described above.

Combining with existing organization themes

If your organization already uses custom themes, you can combine them with the ZoomCharts license theme. You can combine the .json files yourself in your ZoomCharts account.

Or send your existing theme to [email protected], and the ZoomCharts team will merge it for you.

Summary and recommendations

• Use individual licensing for testing or small reports
• Use report-level themes if you have few developers and it’s easy to distribute the license theme
• Use organization-level themes for large teams and centralized management (recommended)

Applying the correct method will save time, reduce errors, and ensure all Drill Down Visuals function correctly with licensed features enabled.