Applications
An Application gathers pages from many reports of a workspace in one place. Viewers open one application, with a cover page and a navigation pane, instead of opening each report. You add a logo and a cover image, order the pages in sections, and choose who may view it.
Before you start
Section titled “Before you start”- Open a shared workspace. In the sidebar, under General, click Applications. A My workspace and the workspace of a My org cannot hold an application; the page says so.
- Workspace Editors and Admins, and organization Owners and Admins, create and edit applications. A Viewer cannot.
- A report must be published before you add its pages.
Create an application
Section titled “Create an application”- Click New application.
- Enter a Name (1 to 100 characters, unique in the workspace) and an optional Description (up to 500 characters).
- Click Create. The editor opens, with the tabs Content and Settings.
The list has two tabs: In this workspace and Shared with me (applications of other workspaces that you are picked for). Each row shows Name, Status, Audience and Updated.
Add content
Section titled “Add content”In Content, click Add item and pick a kind:
| Item | What it adds |
|---|---|
| Report pages | Pages of a report of this workspace. Pick the report, then All pages or Selected pages. The pages stay in the report: the application shows them, it does not copy them. More than one page goes into a new section named after the report. |
| Section | A folder that holds other items. |
| External link | A link to a website. Only https:// addresses, up to 2,048 characters. It opens in a new tab. |
| Image | A PNG, JPEG or WebP picture, up to 1 MB. |
Drag items to reorder them. Drop an item on a section to put it inside. You can rename and remove items. An application holds up to 200 items in at most 3 levels, and up to 250 images.
All pages adds the pages the report has now. A page added to the report later does not appear by itself: someone with permission adds it here.
Settings
Section titled “Settings”In Settings:
| Setting | What it does |
|---|---|
| Name, Description | The title and the text on the cover page. |
| Logo | A picture shown in the application header (Upload, Replace, Remove). |
| Cover image | A picture on the cover page. |
| Accent color | A color such as #1677ff. Default color goes back to the standard one. |
| Show navigation pane | Shows the left pane that lists the items. Viewers can collapse it. |
| Home | Cover page: a generated page with the logo, name, description, cover image and one card for each top level item. First item: the first top level item opens as Home. It must be a report page or an image. |
Preview, publish and unpublish
Section titled “Preview, publish and unpublish”Every change goes to a draft. Click Preview to see the draft, with a banner that viewers see only the published version. Click Publish to make the draft what viewers see. The list shows Draft, Published or Unpublished changes when the draft differs from what is published. The name changes at once, without publishing.
Click Unpublish to take the application away from viewers at once. You can still edit it.
Choose who can view it
Section titled “Choose who can view it”Click Audience (Who can see this application) and pick:
- All members of the workspace: everyone who has a role in the workspace.
- Picked organization members and groups: only the people and groups you pick (up to 500). They do not need a role in the workspace.
Workspace Editors and Admins always see it. A change of audience applies at once, without publishing again.
An application gives its audience view only access to exactly the report pages you put in it, and only through the application. It gives no access to the report itself, its data model or Explore. Row-level security of the data model still applies to each viewer. An application has its own audience, so it shows its pages even when a report has page permissions that hide them from the viewer when they open the report directly.
Notifications
Section titled “Notifications”When people become part of the audience of a published application, they get a notification in the bell: You can now view application followed by the name. Click it to open the application. This also happens at the first publish. There is no e-mail. You do not get one for your own change, and neither do people who could already see it.
Delete an application
Section titled “Delete an application”Click Delete on the application. It moves to the workspace Trash and can be restored for 30 days. Viewers lose access at once. See Trash.
Maps in applications
Section titled “Maps in applications”A Shape map in an application page draws like it does in the report, also with a custom map you uploaded.