**Version: 202601**

# Set card properties

**PATCH** `/openapi/2026-01/themes/edit-sessions/:oseid/sections/:section_id/props`

Set/merge properties into a card's settings within an edit session.

## Request

**Path Parameters**

- `oseid` string (required)

  Edit session ID
- `section_id` string (required)

  Section instance ID inside the document; a global card id (`header`, `footer`, `announcement`, `cart_drawer`) also works

**application/json**

**Body | Example**

**Body (required)**

- `doc_id` string (required)

  Document (template file) ID the section lives in
- `theme_id` string (required)

  Theme ID (used to build the rendering context url)
- `props` object (required)

  Key→value properties to set/merge into the section's settings
- `template_name` string

  Template name, e.g. index. Defaults to the file location without `.liquid`
- `locale` string

  Rendering locale; defaults to en\_US

```json
{
  "doc_id": "string",
  "theme_id": "string",
  "props": {},
  "template_name": "string",
  "locale": "string"
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `section` object

    The updated section object
  - `html` string

    Rendered section HTML. Empty when the target is a global card (header / footer / ...) — those are not re-rendered per section

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