> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.templated.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Embedded Editor Permissions

You control what your users can do in the Templated embedded editor in two places:

1. **The Embedded Editor page of the dashboard** (https://app.templated.io/embed): permissions for the whole embed configuration.
2. **URL parameters** in the embed URL: options you can change per page or per user.

Some options exist only in one of the two places. This article lists both.

## Permissions set in the dashboard

Open https://app.templated.io/embed, expand the permissions section, change the switches and save.

| Setting | What it does | Default |
|---|---|---|
| Allow Rename | Users can change the template name | On |
| Allow Save | Users can save changes to templates | On |
| Allow Resize | Users can change the canvas size | Off |
| Allow Multi-Page | Users can add pages to templates | On |
| Allow Download | Shows the Download button so users can render and download | On |
| Allowed download formats | Which formats users can download: JPG, PNG, PDF | |

Important: these settings are controlled in the dashboard. Adding `allow-download=false`, `allow-save=false`, `allow-rename=false` or `allow-resize=false` to the URL does **not** turn them off. To hide the Download button or block saving, change the setting in the dashboard.

Tip: to remove the Save button but still save from your own button, keep Allow Save on and add `&hide-save-button=true` to the URL. Then save with the `SAVE` message (see "Embedded Editor Events") or Ctrl/Cmd + S.

## Permissions set in the URL

Add these to the embed URL, for example `https://app.templated.io/editor/TEMPLATE_ID?embed=EMBED_ID&allow-edit-text-only=true`.

| Parameter | What it does |
|---|---|
| `allow-edit-text-only=true` | Only text layers can be selected, moved, resized and edited. Images, shapes and videos are locked. |
| `allow-create-template=false` | Users cannot create new templates from the editor. |
| `allow-template-selection=true` | Adds a Templates tab so users can switch to another template. |
| `allow-video=true` | Shows the video timeline, play and pause, and video settings. |
| `allow-layer-unlock=false` | Users cannot unlock layers you locked in the template. |
| `allow-layer-rename=false` | Users cannot rename layers. |
| `clone=true` | Users edit a clone, so your original template never changes. |

### Lock parts of the design

The simplest way to keep parts of a design fixed is to **lock those layers** in the Templated editor before embedding (lock icon in the layers panel). Locked layers cannot be moved or edited by your users. Add `&allow-layer-unlock=false` so they cannot unlock them.

## Hide parts of the interface (URL)

| Parameter | What it hides |
|---|---|
| `hide-sidebar=true` | The left sidebar with the tabs |
| `hide-tabs=barcode,qr-code,rating` | Only some sidebar tabs. Names: text, images, videos, shapes, vectors, uploads, qr-code, barcode, rating |
| `hide-header=true` | The top header bar |
| `hide-layers-panel=true` | The layers panel |
| `hide-save-button=true` | The Save button (saving still works with Ctrl/Cmd + S and the `SAVE` message) |
| `hide-language-toggle=true` | The language switcher |
| `hide-canvas-background=true` | The dotted background behind the canvas |

## Preview Mode and Form Mode permissions

In **Preview Mode** (`/editor/preview/TEMPLATE_ID?embed=EMBED_ID`), only the canvas is shown and nothing can be changed unless you allow it. Use these URL parameters:

| Parameter | What it allows |
|---|---|
| `allow-layer-select=true` | Selecting layers |
| `allow-layer-move=true` | Moving layers |
| `allow-layer-resize=true` | Resizing layers |
| `allow-text-edition=true` | Double-click to edit text |

You can also change them after loading with messages like `SET_ALLOW_LAYER_MOVE`. These four parameters are meant for Preview Mode. In the normal embedded editor, users can already select, move and resize unlocked layers.

In **Form Mode** (`/editor/form/TEMPLATE_ID?embed=EMBED_ID`), unlocked layers appear as form fields and locked layers are hidden from the form.

Docs: https://templated.io/docs/embed/preview-mode/ and https://templated.io/docs/embed/form-mode/

## Examples

Users can only change texts, on a copy of your template, without creating new templates:

```
https://app.templated.io/editor/TEMPLATE_ID?embed=EMBED_ID&clone=true&allow-edit-text-only=true&allow-create-template=false
```

Simple editor without the advanced tabs:

```
https://app.templated.io/editor/TEMPLATE_ID?embed=EMBED_ID&hide-tabs=qr-code,barcode,rating,vectors
```

Full parameter list: https://templated.io/docs/embed/url-parameters/

## FAQ

Q: How do I hide the Download button?
A: Turn off Allow Download on the Embedded Editor page of the dashboard. The URL parameter does not hide it.

Q: How do I allow only PNG downloads?
A: In the dashboard, keep Allow Download on and select only PNG in the allowed download formats.

Q: How do I stop users from saving?
A: Turn off Allow Save in the dashboard.

Q: How do I let users change only the text?
A: Add `&allow-edit-text-only=true` to the URL.

Q: How do I stop users from moving my logo?
A: Lock the logo layer in the template and add `&allow-layer-unlock=false` to the URL.

Q: Can users resize the canvas?
A: Only if Allow Resize is on in the dashboard. It is off by default.

Q: Can I stop users from adding pages?
A: Yes. Turn off Allow Multi-Page in the dashboard.

Q: Is there a `download-formats` URL parameter?
A: No. Choose the allowed formats on the Embedded Editor page of the dashboard.