Configure theme app extensions

Detailed technical documentation and implementation guide for Configure theme app extensions.

Extension Manifest (joonweb.extension.json) #

Deep Linking Specification #

Post-installation, your app can deep-link merchants directly into the Site Builder to activate embeds or add section blocks automatically.

### 1. For Embed Extensions (`app_embed`)
```text
https://accounts.joonweb.com/site/builder/?activate_extension={extension_uid}/{block_handle}
```
* **Example**: `https://accounts.joonweb.com/site/builder/?activate_extension=7720ed2b-c190-44ba-bf1b-f1b096e1e587/lastSold-section-block`
* **Parameters**:
  * `extension_uid`: Extension UID string from `joonweb.extension.json`.
  * `block_handle`: Filename of the block file (without `.jw`).

### 2. For Section Extensions (`app_sections`)
```text
https://accounts.joonweb.com/site/builder/?add_extension={ext_uuid}/{ext_block}&target_page=collections
```
* **Example**: `https://accounts.joonweb.com/site/builder/?add_extension=7e24ff92-9362-4765-8909-bdb2905f001f/reels-section-block&target_page=products`
* **Parameters**:
  * `add_extension`: `{extension_uid}/{block_handle}`
  * `target_page`: Target page URL or ID (`home`, `products`, `collections`, `login`, `signup`). Leave blank for homepage.

Detecting If Embedded App Is Installed #

Fetch active theme configuration via the Admin API to check if your app or block is installed and enabled:

**Endpoint**:
```http
GET https://{yoursite}.myjoonweb.com/api/admin/26.0/themes/current/assets/file?key=theme_config.json
```

**JavaScript Check Function**:
```javascript
const res = await fetch(url, { headers: { 'Authorization': `Bearer ${apiToken}` } });
const data = await res.json();
const config = JSON.parse(data.asset.content);
const blocks = config.blocks || {};

let isInstalled = false;
let isEnabled = false;

// Method A: Check via App Handle
const APP_HANDLE = "my-app";
for (const id in blocks) {
  if (blocks[id].type === "apps" && blocks[id].src.includes(`/apps/${APP_HANDLE}/`)) {
    isInstalled = true;
    isEnabled = blocks[id].enabled === true;
    break;
  }
}

// Method B: Check via Block Name
const block_name = "my-block_file";
for (const id in blocks) {
  if (blocks[id].type === "apps" && blocks[id].src.includes(`/blocks/${block_name}/`)) {
    isInstalled = true;
    isEnabled = blocks[id].enabled === true;
    break;
  }
}

console.log({ isInstalled, isEnabled });
```

What's Next? #

Last modified: Aug 25, 2026

Configure theme app extensions

Extension Manifest (joonweb.extension.json) #

Deep Linking Specification #

Detecting If Embedded App Is Installed #

What's Next? #

Endpoint Title