---
url: https://docs.youcan.shop/apps/theme_extension/theme-editor-links.md
---

# Theme editor links

Use a link to open the theme editor of the seller's active theme with one of your [app blocks](/apps/theme_extension/getstarted#_2-understand-app-blocks) ready to place. Put the link in your app, for example in your onboarding steps.

All links start with:

```
https://seller-area.youcan.shop/admin/themes/current/edit
```

The seller must be logged in to the store where your app is installed. The changes from a link are not saved: the seller sees the result in the preview, then saves or discards it.

In both links, the block ID is your app ID and the block file name without the `.liquid` extension, joined by `/`. Your app ID is the `id` in `youcan.app.json`.

```
app_F2EJB5TVqhD9wYjejTDfddE1nsw/star-rating
```

## Add an app block

```
https://seller-area.youcan.shop/admin/themes/current/edit?template=product&addAppBlockId=app_F2EJB5TVqhD9wYjejTDfddE1nsw/star-rating&target=mainSection
```

The block is added to the template, and its settings are opened.

| Parameter | Required | Description |
| --------- | -------- | ----------- |
| `addAppBlockId` | Yes | The block ID. Only blocks with the `section` target can be added. |
| `template` | No | The template to open, for example `index`, `product` or `collection`. Defaults to `index`. |
| `target` | No | Where the block is added. Defaults to `newAppsSection`. |

| `target` | The block is added to |
| -------- | --------------------- |
| `newAppsSection` | A new Apps section at the end of the template. |
| `mainSection` | The section with the ID `main` in the template. |
| `sectionGroup:{type}` | A new Apps section at the end of the section group of that type, for example `sectionGroup:footer`. |
| `sectionId:{id}` | The section with that ID, in the template or in a section group. |

When the target section does not exist, or app blocks are not allowed in it, the block is added to a new Apps section at the end of the template. When the block cannot be added at all, for example because the template has the maximum number of sections, an error message is shown to the seller.

## Open an app embed

```
https://seller-area.youcan.shop/admin/themes/current/edit?context=apps&activateAppId=app_F2EJB5TVqhD9wYjejTDfddE1nsw/announcement-bar
```

The App embeds panel is opened with your app's embeds, and the settings of the embed are shown. The seller turns the embed on and saves.

| Parameter | Required | Description |
| --------- | -------- | ----------- |
| `context` | Yes | Always `apps`. |
| `activateAppId` | Yes | The block ID. Only blocks with the `head` or `body` target can be opened. |