> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Shared Dashboard

> View a read-only dashboard via a share token link, without requiring a full platform login. Alternate route: /dashboard/shared.

Shared dashboard viewer at `/dashboard/shared/:shareToken` that renders a read-only dashboard for recipients of a share link. The alternate route `/dashboard/shared` is a parent segment with no standalone page.

## Overview

The Shared Dashboard page validates a `shareToken` URL parameter via `useValidateShareToken`. On valid token, it renders the associated dashboard's widget grid using `WIDGET_REGISTRY` and `getWidgetGridSpan` for layout. Missing widget definitions render a placeholder card. Error states handle `expired` and `not_found` tokens. The page shows the share metadata (e.g., expiry time badge) alongside the widgets. The primary route is `/dashboard/shared/:shareToken`; `/dashboard/shared` without a token has no dedicated page.

## Who it's for

Access follows your organization's role and module configuration. Access is controlled by possession of a valid share token.

## Before you start

* You must have received a valid dashboard share link containing a `shareToken`.
* Share tokens may have an expiration time; verify the link is current before sharing.

## Steps

1. Open the share link provided to you (it contains the `shareToken`).
2. View the rendered dashboard. Controls are read-only.
3. If the link shows an "expired" error, request a new share link from the dashboard owner.

## Key concepts

**shareToken** — A unique token embedded in the share URL that identifies which dashboard to render and for how long it is valid.

**Widget registry** — The set of dashboard widget types the platform can render. Unrecognized widget IDs show a placeholder.

**Expiration** — Share tokens have a validity window. SME: confirm the default duration and whether it is configurable.

## Related

<Columns cols={2}>
  <Card title="Platform Foundation" icon="layer-group" href="/pf/overview">
    Platform Foundation overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/platform.tsx
  * src/platform/dashboard/pages/SharedDashboardPage.tsx
  * src/platform/dashboard/hooks/useDashboardShares.ts
  * src/platform/dashboard/widget-registry.ts
</Accordion>