Publish widgets or dashboards
Overview
You can publish any widget or dashboard as a public embed, making it accessible to anyone with the link. Published embeds can be placed on external websites, social networks like Facebook, X, or LinkedIn, or internal company dashboards. Each published link has its own time period configuration, so you can share multiple views of the same data without changing the original widget or dashboard.
Prerequisites
- A GameAnalytics account with a role that has publish permissions. See User access below for the full permissions table.
- At least one widget or dashboard already created in your Game.
Publishing a widget
Open the publish widget menu
- Navigate to the widget you want to publish.
- Click the three-dots menu (⋮) in the top-right corner of the widget.
- Select Publish.
If you have never published this widget before, the publish configuration form opens automatically. If you have published it before, you see a list of existing published links instead. Click Create new to add another.
Configure the widget embed
The configuration form includes the following options:
| Option | Description |
|---|---|
| Overwrite title | Overrides the widget title in the embedded view only. The original title in your dashboard is not affected. |
| Time period | Sets the time range for the embedded data. Choose a relative period. |
The available time period options are:
| Period | Description |
|---|---|
| Last 7 days | Rolling 7-day window relative to the current date |
| Last 30 days | Rolling 30-day window relative to the current date |
You can also toggle Include current day to include or exclude today's data from relative periods.
Publish widget
Click Publish to generate the embed link. Once published, a code snippet is available to copy and paste into any HTML page.
Embedded size is automatically set by the system and included in the embed snippet. You do not need to configure it manually.
Multiple links
You can create multiple published links for the same widget, each with a different time period. This is useful for side-by-side comparisons, for example sharing a "last 7 days" view alongside a "last 30 days" view.
Publishing a dashboard
Open the publish dashboard menu
- Navigate to the dashboard you want to publish.
- Click Share in the top-right corner.
- Select Publish.
If you have never published this dashboard before, the publish configuration form opens automatically. If you have published it before, you see a list of existing published links instead. Click Create new to add another.
Configure the dashboard embed
The configuration options are the same as for widgets. See Configure the widget embed above.
Publish dashboard
Click Publish to generate the embed link and copy the snippet code.
Managing published links
View published links
When you click Publish on a widget or dashboard that already has published links, a list of all links you have access to appears. Each entry shows the configured time period and the name of the user who created it.
Copy embed snippet
Click the copy icon next to any published link to copy the embed snippet to your clipboard.
Unpublish a single link
- Click the delete icon next to the link you want to remove.
- Confirm the action.
The embed link is permanently removed. Anyone viewing that embed will see an "Embed is not available" message.
Unpublish all links
Click Unpublish all to remove every published link for the widget or dashboard at once. This button is only visible if your role has the required permissions.
Unpublishing a link is immediate and permanent. Any website or page currently displaying the embed will show a broken state. Make sure no one relies on the link before removing it.
Editing a published widget or dashboard
If you modify a widget or dashboard that has active published links, a confirmation dialog appears:
You're about to modify a published widget/dashboard
Changes to this widget's configuration will immediately affect its behavior and visible state for anyone accessing it. This may impact dashboards, embedded views, or shared links currently in use.
Click Confirm to apply your changes, or Cancel to discard them. There is no way to version or roll back a published embed, so changes take effect immediately.
Published embed experience
The published embed is a read-only view. It does not include interactive controls like zoom or edit.
A Powered by GA logo appears at the bottom of every embed and links to gameanalytics.com.
Broken or unpublished link
If someone visits an embed link that has been unpublished or is otherwise invalid, they see a message:
Embed is not available
The owner has unpublished this embed or it does not exist. You can no longer view its data.
User access
Not all roles can publish or manage embed links. The table below shows which actions are available for each role.
Widget permissions
| Action | Org. Primary Owner | Org. Owner | Org. Admin | Org. Viewer | Studio Admin | Studio Viewer | Game Admin | Game Viewer |
|---|---|---|---|---|---|---|---|---|
| Publish widget | Yes | Yes | Yes | No | Yes | No | Yes | No |
| View your own published links | Yes | Yes | Yes | No | Yes | No | Yes | No |
| View links published by other users | Yes | Yes | Yes | No | Yes | No | Yes | No |
| Delete your own published links | Yes | Yes | Yes | No | Yes | No | Yes | No |
| Delete links published by other users | Yes | Yes | Yes | No | No | No | No | No |
| Unpublish all | Yes | Yes | Yes | No | No | No | No | No |
Dashboard permissions
| Action | Org. Primary Owner | Org. Owner | Org. Admin | Org. Viewer | Studio Admin | Studio Viewer | Game Admin | Game Viewer |
|---|---|---|---|---|---|---|---|---|
| Publish dashboard | Yes | Yes | Yes | No | Yes | No | Yes | No |
| View your own published links | Yes | Yes | Yes | No | Yes | No | Yes | No |
| View links published by other users | Yes | Yes | Yes | No | Yes | No | Yes | No |
| Delete your own published links | Yes | Yes | Yes | No | Yes | No | Yes | No |
| Delete links published by other users | Yes | Yes | Yes | No | No | No | No | No |
| Unpublish all | Yes | Yes | Yes | No | No | No | No | No |
What restricted users see
- If you do not have permission to publish a widget, the Publish option does not appear in the three-dots menu.
- If you do not have permission to publish a dashboard, the Publish tab does not appear in the Share popover.
- If you do not have access to a published embed link, it simply does not appear in the list.
- If you do not have permission to delete a link, the delete button is disabled with a tooltip explaining that you do not have the required access.
- If you do not have access to Unpublish all, the button is hidden.
Troubleshooting
| Problem | Solution |
|---|---|
| Embed shows "no longer available" | The link was unpublished or the embed ID is invalid. Ask the widget/dashboard owner to re-publish. |
| Changes to my widget are not reflected in the embed | Changes apply immediately. Clear your browser cache or reload the embed page. |
| I cannot see the Publish option | Your role does not have publish permissions. Contact your Organization admin to request access. |
| I cannot delete another user's published link | Only Org. Primary Owner, Org. Owner, and Org. Admin roles can delete links created by other users. |
Related resources
- GA user roles and permissions for a complete overview of all role capabilities.
- Dashboards for creating and managing dashboards.