Overview
Library Charts is the persistent catalog of Charts inside Lens. It collects every Chart a Lens Designer has authored, been shared, or can read as a system-generated artifact. The surface organizes these into three tabs — My Charts, Shared Charts, and System Charts — and exposes per-row Actions for the operations a Designer performs on a Chart after it has been built and published.
Library Charts is accessed from Lens → Library → Charts. Charts are authored in the Chart Designer; Library is where they are organized, recovered, shared further, scheduled, sent, embedded, or removed. The Actions available on a Chart are gated by publish state — an unpublished Chart appears in the list but exposes no Actions until it is published from the Chart Designer.
When to use it
- Locate a Chart you authored to edit, share, schedule, or delete it.
- Open a Chart another Designer has shared with you.
- Read a system-generated Chart.
- Recover a previously saved version of a Chart after an unwanted edit.
- Embed a published Chart in an external page or another Report.
Tabs
| My Charts | Charts authored by the signed-in Designer. | Standard column set (Name, Created Date, Updated Date, Security Tags, Status, Actions); full Actions column on published Charts. |
| Shared Charts | Charts another Designer has shared with the signed-in user. | Owner column shows the sharer’s email; Shared Date column replaces Created Date. |
| System Charts | Charts marked as system charts by the platform. | Standard column set without Owner and actions. |
Columns
| Name | Chart title. |
| Owner | Email of the user who shared the Chart. Present on Shared Charts only. |
| Created Date | When the Chart was created. Present on My Charts and System Charts. |
| Shared Date | When the Chart was shared with the signed-in user. Present on Shared Charts. |
| Updated Date | Timestamp of the most recent change. |
| Security Tags | Tags attached to the Chart that govern access at view time. Tags are configured in Lens and applied at Chart design time. |
| Status | Publish state of the Chart. |
| Actions | Icons for the operations available on the Chart in this tab. Empty until the Chart is published. |
Actions
Action availability differs by tab and by publish state.
| Share | Shares the Chart with users, scoped by role. |
| Edit | Opens the Chart in the Chart Designer for editing. |
| Embed Link | Generates a URL or iframe for embedding the Chart. Configurable Type (Secure / None / Anonymous), Display Type (Fit / Scroll), and optional Domain Name. |
| Schedule | Creates a scheduled job that delivers the Chart on a recurring or one-time schedule. |
| Delete | Removes the Chart after a confirmation prompt. |
| Recovery | Rolls the Chart back to a previously saved version selected from a timestamped list. |
Embed Link
The Embed Link action produces a sharable URL or iframe for the Chart. The configuration controls who can open the embedded view and how it renders in the host page.
| Type — Secure | Protects the URL. The link cannot be opened anonymously. |
| Type — None | URL is openable without credentials. |
| Type — Anonymous | URL is openable without credentials. |
| Display Type — Fit | Renders the Chart contents on a single page. |
| Display Type — Scroll | Renders the Chart with vertical scrolling for long content. |
| Domain Name | Optional. Restricts the embed to a specific host domain. |
| URL | Generated link. Can be copied and shared. |
| iframe | Generated iframe HTML. Can be pasted into a Report’s HTML editor or any external page. |
Embed Link configuration is preserved when Save is clicked on the Embed Link pop-up. Reopening the pop-up later shows the saved selections.
Recovery
Recovery preserves saved versions of a Chart and provides a roll-back path. When the Recovery action is used, a list of timestamped saved versions appears; selecting one overrides the current Chart with that version.
Key behaviors
Publish gates the Actions column. A Chart exists in Library as soon as it is saved, but its Actions column remains inert until the Chart is published from the Chart Designer. Publish is the threshold at which a Chart becomes shareable, schedulable and embeddable.
Tab determines audience and Action set. My Charts / Shared Charts / System Charts each scope the visible Charts differently. The same Chart can appear in multiple users’ Library Charts surfaces — once for the owner under My Charts, again for each share recipient under Shared Charts.
Security Tags govern view-time access. Security Tags configured in Lens are attached to Charts at design time and stored in the Security Tags column. At view time, the tag’s Report Access Options determine whether a user can open the Chart, regardless of which Library tab the Chart appears in for them.
Recovery is version-based. Recovery rolls a Chart back to a saved version chosen from a timestamped list. It is a versioning safety net rather than a full undo — only saved states are recoverable.
Embed Link bridges Lens Charts to external surfaces. URL and iframe variants are produced from the same configuration; URL is for direct sharing and iframe is for in-page embedding (including inside a Lens Report’s HTML editor). The Type setting determines whether the embedded Chart requires credentials.
Charts travel as standalone artifacts. A Chart in Library can be scheduled, embedded, or shared independently of any Report it appears in. The Library Charts surface treats every Chart as a first-class artifact — there is no requirement that a Chart be tied to a Report to be usable.