# Embed Artavolo in your own application

> Show an editable Artavolo table inside your own product with a signed, short-lived token: no login for your users, never more access than the account.

Source: https://artavolo.com/page/embed-in-your-application

Your own application can show an Artavolo table, board, calendar or form inside its pages. Your users work with the records, edit them if you allow it, and never see a sign-in screen. Your server signs a short-lived token naming an Artavolo account and a base; a frame in your page opens with it.

## How it works

The token names an Artavolo account, the base, optionally the one table to open, whether it may write, and a label for your own user. An embedded session can only ever do less than that account: no settings, no members, no permissions, no import, no administration, and nothing outside the base or table in the token. Every request is checked against the token, so it works even where browsers block third-party cookies.

## See it working first

1. Open the administration (**Control panel** in the account menu), then **Settings**, **Embedding**.
2. Under **Try it now**, pick one of your bases, a table or **The whole base**, and **Read only** or **Read and write**.
3. Press **Generate** and open the link. That is an embedded view, acting as you, for ten minutes.

The same box then prints the code with your instance address, account and base already filled in, for PHP, for Node, or for the demo command.

## Set it up for real

1. Create the Artavolo account the embedded view will act as, and give it exactly the access your users should have. Do not use an administrator.
2. In **Settings**, **Embedding**, tick **Accept embed tokens**.
3. Add your application's address under **Allowed host origins**, one per line, such as `https://app.example.com`. Any other site is refused.
4. Copy the **Signing secret** to your server. Never put it in browser code.
5. On your server, sign a token for each page load and put it in the frame's address. The [embedding guide](https://artavolo.com/docs/embedding) has the token format and working code in PHP, Node and Python, and a client package with React and Vue wrappers.

## While it runs

The frame tells your page when it is ready, how tall it needs to be, and when records change, so your own screens can stay in step. Your page can ask it to reload.

## Good to know

- Setting it up needs administrator access to the instance, so it is done on your own server or on a dedicated instance. On your own server it needs a licence key that includes embedding; it is quoted with White-label or Enterprise.
- Without white-labelling, an embedded view keeps a small "powered by" line.
- Tokens should be short-lived: mint a new one per page load. The session inside the frame then lasts as long as the browser session, so nobody is interrupted mid-edit.
- Every embedded session is in the audit log with your label for the user, so changes can be traced to your own users.
- **Rotate** beside the signing secret refuses every token signed with the old one at once.
- A blank frame usually means your address is missing from **Allowed host origins**. A signature error means a wrong secret, and an expired token often means a server clock that is out.
- Desktop applications (Electron, Tauri, WebView2) work too; the guide explains the one thing that differs.
- For a public, read-only view on a website, guest access is simpler. See [Show a base on a website](https://artavolo.com/page/embedding-a-sheet).

## Related

- [Show a base on a website](https://artavolo.com/page/embedding-a-sheet)
- [Use the REST API and API tokens](https://artavolo.com/page/rest-api-and-tokens)
- [Apply a licence key](https://artavolo.com/page/apply-a-licence-key)
- [Embedding guide for developers](https://artavolo.com/docs/embedding)
