Microsoft Learn, as of Nov 2026

How to add a custom visual to the Power BI organizational store (2026)

By · Founder & Reliability Engineer · Updated

Why the organizational store

The organizational store (Organizational visuals in the Fabric admin portal) is a tenant-wide list of custom visuals a Fabric admin has approved. Three properties make it the standard route for in-house, vendor and AI-generated visuals:

  • It bypasses the two tenant switches that block visuals: organizational visuals aren't affected by “Allow visuals created using the Power BI SDK” or certified-only mode[1].
  • It deploys to Power BI Desktop automatically, under Get more visuals → My organization[2].
  • The admin controls the version. One update reaches every report, and one switch retires the visual everywhere[2].

Not sure whether your tenant needs it? Run the tenant check first; it tells you per scenario.

Before you upload: a 5-minute review

A file you upload yourself hasn't been through Microsoft's certification review, so the review is your security team's job. Our suggested checklist (not a Microsoft requirement):

  • Privileges.Does capabilities.json request WebAccess, and to which domains? Visuals created with the SDK can send data outside your tenant's geographic or compliance boundary[11]. Requests for ExportContent are also governed by “Allow downloads from custom visuals”[2].
  • Code.Ask for the source, or at least scan the compiled bundle for fetch, XMLHttpRequest and eval, which Microsoft's certification rules forbid, and check that any innerHTML never receives report data (the rules ban it only with user data; d3 itself uses it)[3].
  • Identity.Record the file hash and the visual's GUID and version, so you can tell later which build is live.

The free pbiviz Inspector reads all of this in the browser, and the tenant check bundles it with the SHA-256 into an admin pack.

Add a .pbiviz from a file

  1. Open Organizational visuals. Sign in with a Fabric administrator account and open Fabric admin portal → Organizational visuals. It isn't in the Power Platform admin center.[2]
  2. Add from a file. Select Add visual → From a file.[2]
  3. Fill in the form. Choose the .pbiviz file, name the visual, optionally upload an icon and write a short description, and leave Access enabled (the default).[2]
  4. Add. Select Add. The visual appears in the organizational visuals list.[2]
  5. Optionally pin it. Select the visual and turn on Enable for Visualization Pane so it shows for every report author without searching.[2]
  6. Tell authors where it is. Authors find it in Power BI Desktop or the service under Get more visuals → My organization.[5]

Add a Marketplace visual instead

For a visual that is on the Microsoft Marketplace, use Add visual → From AppSource rather than uploading its file. Visuals added that way update automatically and keep their certification, including export to PDF and PowerPoint[5].

Some visuals must be added this way: Microsoft names Visio, Mapbox, Power Automate and Charticulator[4]. If you uploaded a file version earlier, the admin article describes replacing it with the AppSource version[2].

Update, disable, delete

Ship a new version

  1. In Organizational visuals, select the visual and open Settings.[2]
  2. Select Browse, choose the new .pbiviz and select Update. Reports using the visual pick up the new version.[2]

Disable it temporarily

In the visual's Settings, turn off Access (“Users in the organization can access, view, share, and interact with this visual”). Reports then show “This custom visual is no longer available. Contact your administrator for details.”[2]

Delete it

Deleting can't be undone and the visual stops rendering in existing reports immediately[2]. Prefer disabling first if anyone might still depend on it.

What the organizational store can't do

  • Make an uncertified visual export to PowerPoint or appear in subscription emails: only certified visuals imported from the Marketplace support that[4]. See certified vs uncertified.
  • Work in Power BI Report Server, which doesn't support organizational visuals[2]. See Report Server compatibility.
  • Override Publish to web limits: uncertified org visuals aren't supported there while certified-only mode is on, nor are Marketplace visuals from the org store when the SDK setting is off[6].
  • Override “Allow downloads from custom visuals”, which applies to organizational visuals too[2].

Visual is in the store but still not rendering? Work through custom visual not showing in Power BI.

FAQ

Who can add visuals to the organizational store?

A Fabric administrator, from the Organizational visuals page of the Fabric admin portal. Workspace admins and report authors can't, and the page isn't part of the Power Platform admin center.

Do organizational visuals still need the SDK visuals tenant setting?

No. Microsoft states that visuals allowed on the Organizational visuals page aren't affected by "Allow visuals created using the Power BI SDK" or "Add and use certified visuals only (block uncertified)", whatever their certification status. That's why it's the route that works in locked-down tenants.

Will organizational visuals export to PDF or PowerPoint?

Only if the visual is certified and was added From AppSource, which keeps its certification. An uncertified visual uploaded from a file can't be exported to PowerPoint or shown in subscription emails.

Do organizational visuals work in Power BI Report Server?

No. Report Server doesn't support organizational visuals; each report carries its visual, imported from a file in Power BI Desktop for Report Server.

What happens to reports when I update the .pbiviz?

Every report that uses the organizational visual picks up the new version.

Sources

Microsoft Learn pages, read as of Nov 2026. The date is the page's own “last updated” stamp at the time.

  1. [1]Power BI visuals tenant settings(opens in a new tab)Microsoft Learn · revised Sep 29, 2026
  2. [2]Manage Power BI visuals admin settings (organizational visuals)(opens in a new tab)Microsoft Learn · revised Sep 1, 2026
  3. [4]Power BI organizational visuals: considerations and limitations(opens in a new tab)Microsoft Learn · revised Dec 15, 2025
  4. [5]Power BI custom visuals FAQ(opens in a new tab)Microsoft Learn · revised Dec 4, 2025
  5. [6]Publish to web from Power BI: considerations and limitations(opens in a new tab)Microsoft Learn · revised Nov 20, 2025
  6. [11]Main sources for acquiring Power BI custom visuals(opens in a new tab)Microsoft Learn · revised Dec 15, 2025

Generate a visual made for the organizational store

Describe the chart and VizForge generates the .pbiviz with its full TypeScript source and no network privileges, so your admin can review it and upload it From a file. It isn't Microsoft-certified, so keep it off pages you export to PDF or PowerPoint.

Generate a custom visual with AI · starts free →

Make the report.
Then make it yours.

The Design Studio, templates and tools are free with no account (exports carry a small VizForge mark until you sign in). Sign up when you want AI: 5 credits on us, no card.

Generate a custom visualDesign a page free

Generated visuals are type-checked and built before you download them; one that fails the quality SLA refunds its credits. See all features or pricing.