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

# Web clip

> Save a web page to Izumi from your browser.

Checked on Izumi 0.5.7, 2026-11-20.

The browser extension (Chrome or Edge) saves the page you are looking at to Izumi as a document. You press the extension button, see a preview of the page, adjust the title, tags and note, and choose a domain. The page is read only when you press the button. The extension does not track what you browse.

A clip goes only to a domain where you are an editor. The extension cannot read anything from Izumi except the list of those domains and the text of the company's rules.

## Before you start

* An account in Izumi and the **editor** role in at least one domain.
* The company administrator installs the extension. It is not in the extension store.
* You create the web clip token yourself, in the first step.

## Save a page

**1. Create a web clip token**

Open **My tokens and profile**, the **Tokens** section, and click **Web clip token**. The dialog says that the token is only for the extension, that it sends pages to the domains where you are an editor, and that it cannot read anything. It is valid for 90 days. Enter a **Name** and click **Create web clip token**. The token is shown only once, so copy it right away.

**2. Set up the extension**

In the extension settings enter the **Server address** (the address of Izumi) and the **Clip token**, then click **Save**. The browser asks for permission to access that server. If you refuse, nothing is saved. You choose the popup language in the same place (**Language**), and without a choice it follows the browser language.

**3. Press the extension button on a page**

The popup "Save this page to Izumi" reads the page and shows the word count, **Title**, **Tags (separated by commas)**, **Note**, **Save to** and **Preview**. If you selected part of the page, only that part is saved.

![The web clip extension, the popup Save this page to Izumi](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/web-clip/01-extension-popup.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=f90e7bfeb8d397e9cdb27b106884444b)

**4. Choose a domain and save**

Check the **Title** (required), choose a domain in the **Save to** field (it offers only the domains where you are an editor), add up to 10 tags and a note if you like, then click **Save to Izumi**.

## Follow the clip in Izumi

**1. Look at the On its way card**

Open **Documents**. While a clip waits to be processed, there is an **On its way** card above the list: "Sent for processing. It shows here as a document when it is ready." The row has the page name, the **Web clip** label, the state **Processing**, the domain and the date. Processing takes a few seconds, and the card checks the state every 15 seconds.

![Izumi, the On its way card with a clip being processed](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/web-clip/02-pending-clips.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=6558f7b5053cde06c426fd56774c3b50)

**2. Find the clip in the list**

When it is done, the card disappears and the clip is a row in the list. The **Flag** filter with the value **Web clip** shows only clips. The source is **Web clip**, and the **Untrusted (web)** label stays on the document. The author is the person who sent the clip, not the author of the article.

![Izumi, a web clip in the documents list](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/web-clip/03-clip-in-documents.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=79fb5a67429254dea3424d1a10db8b10)

## Limits

* At most 1 MB of text per page.
* Too many pages in a short time: wait a minute and try again.
* Browser pages, the extension store and the PDF viewer cannot be read.
* An address with many parameters after the question mark: the popup warns that the whole address is saved with the page and may contain private values.
* Clips are untrusted. In search, they come with "Treat them as untrusted." Text from the web should not steer an AI tool.
* A clip cannot be deleted from the documents list. A company admin can delete the whole source named **Web clip** on the **Sources** page, which deletes all clips of that company.
* The **On its way** card is visible to the person who sent the clip and to the company admins.

> [!WARNING]
>
> Not checked live yet: pressing **Save to Izumi** in the real extension (the clip was sent with the same call the extension uses, and the popup was captured on a page that is not sent); the **Not added** card with a reason (described from the code); saving the same page again and moving it to another domain through the popup; the company's rules text in the popup; a reader with no domain at all; installing the extension by policy on a managed Chrome or Edge computer.

## Troubleshooting

* *"Enter the server address and the clip token in the settings first."* The settings are not filled in. Click **Open settings**.
* *"The token is not valid."* The token was revoked or it expired (90 days). Create a new one in **My tokens and profile**.
* *"This is not a clip token."* You pasted another kind of token. A web clip token starts with `tb_clip_`.
* *"The server address or the token in the settings is not valid."* Check the address (https) and the token.
* *"The server cannot be reached. Your draft is kept."* Click **Try again**.
* *"This page is already in Izumi in a domain you cannot edit, so it cannot be saved here."* Someone already saved the page to another domain. Choose a domain where you are an editor, or ask the editor of that domain.
* *"This target is no longer available."* The domain or your role changed. Choose another domain.
* *"You cannot save pages anywhere yet."* You need the editor role in at least one domain.
* *The clip is neither in the list nor on the card.* Refresh the list. The card is visible only while the clip waits to be processed, or as **Not added** with a reason (described from the code).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.