**Version: 202601**

# Install market theme

**POST** `/openapi/2026-01/themes/merchant-themes/:remote_theme_id/install`

Install a theme from the theme market into the current store by its market theme id. Supports specifying the theme name and style preset, and setting it as the store's default theme; if the store has no default theme yet, the installed theme becomes the default automatically.

## Request

**Path Parameters**

- `remote_theme_id` string (required)

  Remote theme id of the market theme to install

**application/json**

**Body | Example**

**Body (required)**

- `name` string

  Theme display name
- `default` boolean

  Set as the store default theme
- `preset` string

  Style/preset name (from the market theme's presets)
- `version` string

  Theme version to install; defaults to the market theme's current version (`c_version`)
- `sources` string

  Business source tag recorded on the installed theme. Unrelated to CopyThemeRequest.sources
- `admin_hidden` boolean

  Hide the installed theme in the merchant admin
- `ext_suffix` string

  Suffix appended to the extension theme's name; keep it to 15 characters or fewer
- `product_id_map` object[]

  Product id mappings
- `collection_id_map` object[]

  Collection id mappings
- `page_id_map` object[]

  Custom page id mappings

```json
{
  "name": "string",
  "default": true,
  "preset": "string",
  "version": "string",
  "sources": "string",
  "admin_hidden": true,
  "ext_suffix": "string",
  "product_id_map": [
    {}
  ],
  "collection_id_map": [
    {}
  ],
  "page_id_map": [
    {}
  ]
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `data` object

    The installed theme

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "data": {}
  }
}
```