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

# Share and Embed Your Governance Model with External Viewers

> Create a public, read-only link to a governance model that anyone can open without an account, and embed that same interactive view in another site with an iframe.

<Info>
  A shared link is a public, tokenized URL tied to one governance model. Anyone with the link opens a read-only, interactive view of that model's taxonomies. No Terminus Hub account is needed. The same link also drives an iframe embed for any wiki, docs site, or portal. You manage links from the model's Settings, and revoke access by disabling or deleting a link.
</Info>

## Before you start

* You manage shared links from a single governance model's settings, so open the model you want to share first.
* Only account admins can create, edit, or delete shared links. If you are not an admin, the Sharing section will not list any links.

## Create a shared link

<Steps>
  <Step title="Open Settings, then Sharing">
    Open the governance model you want to share, go to its **Settings**, and find the **Sharing** section.
  </Step>

  <Step title="Click Create Shared Link">
    Click **Create Shared Link**. A new link is created immediately with sensible defaults: it is enabled, both call-to-action buttons are on, and a unique link URL is generated. There is no separate save step.
  </Step>

  <Step title="Name the link (optional)">
    Each link row has an inline-editable name, with the placeholder `Untitled Link`. The name is internal only. Viewers never see it. Use it to tell several links apart, for example `Marketing team` or `Docs site embed`.
  </Step>

  <Step title="Copy the link URL">
    While a link is enabled, the row shows the read-only link URL plus a **Link** copy button and an **Embed** copy button. Click **Link** to copy the public share URL. Anyone with that URL can open the read-only view.
  </Step>
</Steps>

## What a viewer sees

The shared view is read-only but interactive. A viewer can pick a taxonomy and try building a value to understand the model, but nothing they enter is ever saved. There is no account, no submission, and no stored data behind the page.

Viewers can switch between these modes from the toolbar:

| Mode        | What it shows                                                      |
| ----------- | ------------------------------------------------------------------ |
| **Quick**   | The default landing mode. A fast, compact way to assemble a value. |
| **Form**    | A field-by-field form layout.                                      |
| **Grid**    | A spreadsheet-style grid for entering values across rows.          |
| **Diagram** | A visual map of the taxonomy structure.                            |

Quick is always the mode a viewer lands on first. A `Powered by terminus.app` link is shown in the footer.

## The two call-to-action buttons

Each link has two optional call-to-action buttons shown to the viewer. Both default on, and you toggle each one independently from the link row:

* **Edit in Playground** opens the model in a throwaway sandbox where the viewer can explore and edit a copy in the real UI. Nothing they change is saved. See [templates and playground](/guides/templates-playground).
* **Sign Up** sends the viewer to the Terminus Hub sign-up page.

Turn either toggle off and that button disappears from the viewer's page. The link URL does not change.

## Embed the model on your site

On any enabled link, click **Embed** to copy an `<iframe>` snippet, then paste it into any HTML page or docs platform.

```html theme={null}
<iframe src="https://hub.terminus.app/embed/your-link-token" width="100%" height="600" frameborder="0"></iframe>
```

The embed shows the same interactive view as the share URL, with two differences:

* The Terminus Hub logo and the taxonomy selector are hidden, so the embed blends into your page.
* The call-to-action collapses to a single **Edit in Playground** link (shown only if that toggle is on), and it opens in a new tab.

<Note>
  The share URL and the embed use the same link. "Embed mode" is purely how the page renders. The copied snippet is a fixed `width="100%"` and `height="600"`. Adjust those values to fit your layout.
</Note>

## Disable or delete a link

There is no expiry date and no password. To revoke access, you either disable the link or delete it.

* **Disable:** turn the link's **enabled** toggle off. The public page then shows `This shared link is no longer available`. The link stays in your list and keeps its name and view count, so you can re-enable it later. While disabled, the URL and call-to-action controls are hidden in Settings.
* **Delete:** click the trash button on the link row and confirm. This permanently invalidates the link. Anyone with the old URL can no longer reach the model.

<Warning>
  Disabling or deleting a link takes effect immediately for everyone who has the URL, including any site that embeds it. An embedded model stops rendering until the link is re-enabled, and a deleted link cannot be recovered.
</Warning>

## The view count

Each link row shows an `N views` count. It increases by one every time the public page is successfully loaded, whether through the share URL or an embed. Loads of a disabled or deleted link do not count. Use it to gauge interest in a shared model.

## What data is shared

A shared link exposes the full structure of one governance model: its taxonomies, fields, and picklist options, so the page can run entirely in the viewer's browser. Anyone with the link can see that full structure. It does not expose submissions, approved records, workspace data, or any way to export the model in bulk.

## Gotchas

* **Admin only.** Creating, editing, and deleting shared links requires account-admin access. Non-admins do not see any links in the Sharing section.
* **Revoke means disable or delete.** There is no expiry or password option. Turn the enabled toggle off, or delete the link.
* **One link, two surfaces.** The share URL and the embed are the same link. There is no separate "embed enabled" switch, and both surfaces count toward the same view count.
* **Quick is the default mode.** A viewer always lands on Quick, not Form.
* **Nothing a viewer enters is saved.** The view is interactive for exploration only. No submissions or records are created from a shared link.

## Related

<CardGroup cols={2}>
  <Card title="Templates and Playground" icon="layout-template" href="/guides/templates-playground">
    Let viewers open a sandbox copy from a shared link, or start a new model from a template.
  </Card>

  <Card title="Governance models" icon="folder-tree" href="/reference/governance-models">
    Build, edit, and publish the model you are sharing.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Set up your first governance model end to end.
  </Card>
</CardGroup>
