# Approval workflows

> Send terms for external review with shareable approval links, per-market links, a read-only full graph view and decision reopening.

**Category:** Collaboration | **Tab:** features

---

Approval workflows let you send terms for review to stakeholders — legal teams, brand managers, regional experts — without requiring them to have a Black Ice account.

## How it works

1. **Select terms** — Choose one or more terms that need review
2. **Create a request** — Add the reviewer's email, an optional message, and any supporting images
3. **Share the link** — The reviewer receives a unique, time-limited link
4. **Review inline** — The reviewer sees a guided presentation of each term and can approve or reject with comments
5. **Track decisions** — All decisions are recorded with timestamps in the approval history

## Creating an approval request

From any concept's detail view:

1. Click **Send for Approval**
2. Select the terms to include
3. Enter the reviewer's email address
4. Add an optional message explaining context
5. Optionally attach images (mockups, screenshots, brand guidelines)
6. Click **Send**

## The reviewer experience

Reviewers don't need an account. They click the link and see a step-by-step presentation:

1. **Welcome slide** — Context about what they're reviewing
2. **Identity verification** — Name, email, and role (if required by your settings)
3. **Concept overview** — The concept being reviewed with its description and class
4. **Term details** — Each term with preferred translation, variants, and context
5. **Visual context** — Any attached images
6. **Related concepts** — Semantic relationships for additional context
7. **Decision form** — Approve or reject each term with optional comments

## Approval settings

Configure approval behavior in **Settings → Permissions**:

| Setting | Description |
|---------|-------------|
| **Require approver identity** | Reviewers must provide name, email, and role |
| **Require role match** | Only specified roles can approve |
| **Allowed approver roles** | Which roles are permitted to review |
| **Default link expiry** | How long approval links remain valid (default: 30 days) |
| **Hide internal notes** | Don't show term notes to external reviewers |
| **Hide market availability** | Don't show market constraints to reviewers |
| **Hide variant lists** | Don't show allowed/forbidden variants to reviewers |

## Approval history

Navigate to **Approval History** to see all past and pending requests, including who reviewed what, when, and their comments.

Each reviewer decision is also written into the term's permanent [decision history](/docs/features/decision-history), labelled **Approval link** (or **Partner agency** when a hired agency reviewed it), together with the reviewer's comment.

## Requests that cover several markets

When you send terms for more than one market, Black Ice creates **one review link per market** as well as the main link.

- **Market links:** each linguist opens the link for their market. They see only that market's terms, with the source term and definition for context, and can decide only those.
- **Decisions are locked:** once a term is decided, nobody can change it from a market link, not even the person who decided it.
- **Main link = read-only overview:** it shows progress per market, every decision with the reviewer's name and comment, and all the market links to forward. Nobody can approve or reject from it.
- **Reopening:** from the overview, the coordinator can reopen a decision for the **same linguist** (their market link works again for that term) or for a **new linguist** for a second opinion (a new link is created and copied). The earlier decision stays in the term's decision history.
- On the **Approvals** page, expand a request to see progress per market and copy each market link.

Requests with a single market work exactly as before: one link that decides everything.


## View full graph (read-only)
During a review, reviewers can click **View full graph** to see how the concept relates to the rest of the ontology, without a Black Ice account.
- It opens on the concept under review and shows its **direct relationships**. Each line has the relationship name written on it (for example *hasFeature*), read in the direction of the arrow.
- Each card shows the class, availability, the source term and the **target term for the market under review**. A market link shows only its own market. The overview can switch between the request's markets.
- **Show concepts two links away** widens the view, and **Whole network** shows everything around it, laid out in columns by distance.
- Click any card or **Under review** chip to recentre the view.
- The graph is read-only and limited to the concepts linked to the request.


## Managing requests

Use search and the filters beneath it, then expand a multi-market request to inspect its market links. Pending requests can be copied or cancelled from the row controls. Deleting a completed or decided request is a separate, confirmed action that removes the request record; preserve request-level evidence first. Term decision history remains separate. Partner monthly statements are independent billing records; deleting a request does not correct a closed statement.
