The visual library is where your organisation's custom visuals are published and kept. Publish a visual once, insert it into any report, and control which version each report uses. To build a visual, see Custom visuals and the visual library.
You need the Publish Organization Visuals permission.
The form refuses incomplete input with Name is required, Name is too long (200 characters max) or Description is too long (2000 characters max). A disabled Add to library button carries its reason, such as Enter a name for the visual, Sample rows are still loading or Fix the blocking checks first.
A draft is visible to its owner and to people who hold Publish Organization Visuals. Everyone else sees the visual only after you publish it.
<n> once the visual has a published version, or Not published yet.| Option | What it does |
|---|---|
| Replace in all dependant reports (N) | Rewrites the pinned tiles as one labelled, restorable report version per report. Detached copies are never touched. |
| New version, dependants stay pinned | Reports keep the version they pinned and show an Update available chip. |
Replace is preselected when the version is compatible with every pinned tile. When a version changes the data roles or options, replace is unavailable: Replace is unavailable: this version changes the data roles or options, so dependant tiles would lose their bindings. Publish it as a new version instead.
With Replace in all dependant reports selected, every listed report changes as soon as you publish. Check the choice first.
Publishing is also refused while the code uses literal colours. The checks a visual passes are described in Sandbox, network and the allowlist.
<n> onto page, then bind the fields the visual reads in the Data well.The picker lists published visuals only. One that cannot be inserted stays listed, dimmed and last; hover it for the reason. When there is nothing to show, it offers Open the visual library, Browse the organization or Clear search.
A visual can reference uploaded files. When the report does not hold them, the picker warns Assets missing from this report; the visual shows them as missing until they are uploaded to the report's assets.
<n> (in this report) beside Library v<n> (candidate) on the tile's own rows.Open DataPrism > Visuals to browse the gallery: one card per visual, with previews drawn from sample data, and controls to filter by status (Published, Draft, Deprecated) or family. Select a visual to open its detail; an open visual has its own link you can share.
. bundle; the gallery's Import adds one as a new draft. See Copy and share custom visuals.| Chip | Meaning |
|---|---|
| Update available | A newer published version exists. Select it to review and update the tile. |
| Deprecated | The visual is deprecated. Reports that use it keep working. |
| Disabled by an administrator | The visual is switched off; its tiles show a placeholder instead. |
| Detached copy | The tile stopped following the library and keeps the version it had. |
| Library visual (no access) | You cannot read the visual's library record, so its name is hidden. |
Yes. Under Version to insert you choose any published version, and the button takes that exact version, so it reads Insert v<n> onto page. The tile stays pinned to that version until someone chooses Update.
A version is compatible when it keeps the same data roles and options as the version before it. A breaking version changes them: it can still be published, but it cannot replace pinned tiles, so each report moves to it only when someone reviews the update.
It keeps working on the version it has and stops following the library. It shows the Detached copy chip, replacing never touches it, and the Used in list counts it separately.
It cannot be inserted: it is Disabled by an administrator or has No published version yet. It stays listed and last; hover it to see the reason.
Yes, for a visual that reads fields: without a sample it is blocked with A data-bound visual needs sample rows for its gallery thumbnail and preview. The add form stores the first 50 rows of the tile by default, and a sample can hold up to 1,000 rows or 256 KiB. A data-free visual, such as a header or a logo, publishes without sample rows.
Open the visual in the library. Used in counts the reports and tiles, for example Used in 3 reports (5 tiles, 1 detached), and each report has an Open link.
Yes. Open the visual, choose Publish on that version in Versions, and decide what happens to the reports that use the visual; it becomes the library head again.
You need Publish Organization Visuals. Writing or editing the code needs Author DataPrism Custom Visuals, and switching a visual off everywhere needs Disable DataPrism Custom Visuals. See Who can do what in DataPrism.