---
title: Asset
description: >-
  Manage the files that make up a store's theme to change the look of the online
  store.
api_version: 2026-07
source_url:
  html: 'https://shopify.dev/docs/api/admin-rest/latest/resources/asset'
  md: 'https://shopify.dev/docs/api/admin-rest/latest/resources/asset.md'
api_name: admin-rest
api_type: rest
---

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate).

# Asset

**Requires \`themes\` access scope.:**

**Note:**

Starting with Admin API 2023-04, if an app distributed through the Shopify App Store uses the Asset resource to create, edit or delete a theme's asset, you need to request the required protected access scope. In most cases, you shouldn't use the Asset resource. To learn more about when you can use the Asset resource, and how to migrate, refer to the [Asset resource](https://shopify.dev/docs/apps/online-store/other-integration-methods/asset).

Theme assets are the individual files that make up a shop's theme.

![](https://shopify.dev/assets/api/reference/asset.png)

A theme's assets include its templates, images, stylesheets, and extra snippets of code. They are arranged among the theme's directories, such as **layout**, **templates**, and **assets**. You can use the Asset resource to add, change, or remove asset files from a shop's theme. For a complete list of theme directories, refer to [*Theme architecture*](https://shopify.dev/themes/architecture).

To learn how to create your own theme, see [*Building themes*](https://shopify.dev/concepts/themes).

\#

## Endpoints

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/asset.md#get-themes-theme-id-assets)

  [/admin/api/latest/themes/{theme\_​id}/assets.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/asset.md#get-themes-theme-id-assets)

  Retrieves a list of assets for a theme

  [theme](https://shopify.dev/docs/api/admin-graphql/latest/queries/theme?example=retrieves-a-list-of-assets-for-a-theme)

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/asset.md#get-themes-theme-id-assets?asset\[key]=templates-index.liquid)

  [/admin/api/latest/themes/{theme\_​id}/assets.​json?asset\[key\]=templates/index.​liquid](https://shopify.dev/docs/api/admin-rest/latest/resources/asset.md#get-themes-theme-id-assets?asset\[key]=templates-index.liquid)

  Retrieves a single asset for a theme

  [theme](https://shopify.dev/docs/api/admin-graphql/latest/queries/theme?example=retrieves-a-single-asset-for-a-theme)

* [put](https://shopify.dev/docs/api/admin-rest/latest/resources/asset.md#put-themes-theme-id-assets)

  [/admin/api/latest/themes/{theme\_​id}/assets.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/asset.md#put-themes-theme-id-assets)

  Creates or updates an asset for a theme

  [themeFilesUpsert](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeFilesUpsert)

  [themeFilesCopy](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeFilesCopy?example=creates-or-updates-an-asset-for-a-theme)

* [del](https://shopify.dev/docs/api/admin-rest/latest/resources/asset.md#delete-themes-theme-id-assets?asset\[key]=assets-bg-body.gif)

  [/admin/api/latest/themes/{theme\_​id}/assets.​json?asset\[key\]=assets/bg-body.​gif](https://shopify.dev/docs/api/admin-rest/latest/resources/asset.md#delete-themes-theme-id-assets?asset\[key]=assets-bg-body.gif)

  Deletes an asset from a theme

  [themeFilesDelete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeFilesDelete?example=deletes-an-asset-from-a-theme)

***

## The Asset resource

### Properties

***

attachment

->[contentBase64](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeFileBodyBase64#field-OnlineStoreThemeFileBodyBase64.fields.contentBase64)

A base64-encoded image.

***

checksum

**read-only**

->[checksumMd5](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeFile#field-OnlineStoreThemeFile.fields.checksumMd5)

The [MD5](https://en.wikipedia.org/wiki/MD5) representation of the content, consisting of a string of 32 hexadecimal digits. May be null if an asset has not been updated recently.

***

content\_type

**read-only**

->[contentType](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeFile#field-OnlineStoreThemeFile.fields.contentType)

The [MIME](https://en.wikipedia.org/wiki/Media_type) representation of the content, consisting of the type and subtype of the asset.

***

created\_at

**read-only**

->[createdAt](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeFile#field-OnlineStoreThemeFile.fields.createdAt)

The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the asset was created.

***

key

->[filename](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeFile#field-OnlineStoreThemeFile.fields.filename)

The path to the asset within a theme. It consists of the file's directory and filename. For example, the asset `assets/bg-body-green.gif` is in the **assets** directory, so its key is `assets/bg-body-green.gif`.

***

public\_url

**read-only**

->[url](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeFileBodyUrl#field-OnlineStoreThemeFileBodyUrl.fields.url)

The public-facing URL of the asset.

***

size

**read-only**

->[size](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeFile#field-OnlineStoreThemeFile.fields.size)

The asset size in bytes.

***

theme\_id

**read-only**

**deprecated**

The ID for the theme that an asset belongs to.

***

updated\_at

**read-only**

->[updatedAt](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeFile#field-OnlineStoreThemeFile.fields.updatedAt)

The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when an asset was last updated.

***

value

->[content](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreThemeFileBodyText#field-OnlineStoreThemeFileBodyText.fields.content)

The text content of the asset, such as the HTML and Liquid markup of a template file.

***

{}

## The Asset resource

```json
{
  "attachment": "R0lGODlhAQABAPABAP///wAAACH5Ow==\n",
  "checksum": "f69db2c563b5be32648ac7367557c09c",
  "content_type": "image/gif",
  "created_at": "2010-07-12T15:31:50-04:00",
  "key": "assets/bg-body-green.gif",
  "public_url": "http://static.shopify.com/assets/bg.gif?1",
  "size": 1542,
  "theme_id": 828155753,
  "updated_at": "2010-07-12T15:31:50-04:00",
  "value": "<div id=\"page\">\n<h1>404 Page not found</h1>\n<p>We couldn't find the page you were looking for.</p>\n</div>"
}
```

***

## getRetrieves a list of assets for a theme

[theme](https://shopify.dev/docs/api/admin-graphql/latest/queries/theme?example=retrieves-a-list-of-assets-for-a-theme)

Retrieves a list of assets for a theme.

**Note:** Retrieving a list of assets returns only metadata about each asset. To retrieve an asset's content, you need to retrieve the asset individually.

### Parameters

***

api\_version

**string**

**required**

***

theme\_id

**string**

**required**

***

fields

Specify which fields to show using a comma-separated list of field names.

***

### Examples

### Retrieve a list of all assets for a theme

### Path parameters

theme\_​id=​828155753

**string**

**required**

get

## /admin/api/2026-07/themes/828155753/assets.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "assets": [
    {
      "key": "layout/theme.liquid",
      "public_url": null,
      "created_at": "2010-07-12T15:31:50-04:00",
      "updated_at": "2010-07-12T15:31:50-04:00",
      "content_type": "application/x-liquid",
      "size": 3049,
      "checksum": null,
      "theme_id": 828155753
    },
    {
      "key": "assets/sidebar-devider.gif",
      "public_url": "https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/sidebar-devider.gif?v=1278963110",
      "created_at": "2010-07-12T15:31:50-04:00",
      "updated_at": "2010-07-12T15:31:50-04:00",
      "content_type": "image/gif",
      "size": 1016,
      "checksum": null,
      "theme_id": 828155753
    },
    {
      "key": "assets/bg-body-pink.gif",
      "public_url": "https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-body-pink.gif?v=1278963110",
      "created_at": "2010-07-12T15:31:50-04:00",
      "updated_at": "2010-07-12T15:31:50-04:00",
      "content_type": "image/gif",
      "size": 1562,
      "checksum": null,
      "theme_id": 828155753
    },
    {
      "key": "assets/bg-content.gif",
      "public_url": "https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-content.gif?v=1278963110",
```

### examples

* #### Retrieve a list of all assets for a theme

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"assets":[{"key":"layout/theme.liquid","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":3049,"checksum":null,"theme_id":828155753},{"key":"assets/sidebar-devider.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/sidebar-devider.gif?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/gif","size":1016,"checksum":null,"theme_id":828155753},{"key":"assets/bg-body-pink.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-body-pink.gif?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/gif","size":1562,"checksum":null,"theme_id":828155753},{"key":"assets/bg-content.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-content.gif?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/gif","size":134,"checksum":null,"theme_id":828155753},{"key":"sections/header_section.liquid","public_url":null,"created_at":"2017-04-28T10:30:00-04:00","updated_at":"2017-04-28T10:30:00-04:00","content_type":"application/x-liquid","size":985,"checksum":null,"theme_id":828155753},{"key":"assets/shop.css.liquid","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/shop.css.liquid?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":14675,"checksum":null,"theme_id":828155753},{"key":"assets/shop.js","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/shop.js?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/javascript","size":348,"checksum":null,"theme_id":828155753},{"key":"assets/bg-main.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-main.gif?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/gif","size":297,"checksum":null,"theme_id":828155753},{"key":"sections/content_section.liquid","public_url":null,"created_at":"2016-02-11T14:31:50-05:00","updated_at":"2016-02-11T14:31:50-05:00","content_type":"application/x-liquid","size":4554,"checksum":null,"theme_id":828155753},{"key":"templates/page.liquid","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":147,"checksum":null,"theme_id":828155753},{"key":"assets/bg-body-green.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-body-green.gif?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/gif","size":1542,"checksum":null,"theme_id":828155753},{"key":"assets/shop.css","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/shop.css?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"text/css","size":14058,"checksum":null,"theme_id":828155753},{"key":"config/settings_schema.json","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/json","size":6769,"checksum":null,"theme_id":828155753},{"key":"sections/product_section.liquid","public_url":null,"created_at":"2016-02-14T16:31:41-05:00","updated_at":"2016-02-14T16:31:41-05:00","content_type":"application/x-liquid","size":1701,"checksum":null,"theme_id":828155753},{"key":"templates/blog.liquid","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":773,"checksum":null,"theme_id":828155753},{"key":"templates/article.liquid","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":2454,"checksum":null,"theme_id":828155753},{"key":"templates/product.liquid","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":2699,"checksum":null,"theme_id":828155753},{"key":"sections/footer_section.liquid","public_url":null,"created_at":"2017-04-28T10:30:00-04:00","updated_at":"2017-04-28T10:30:00-04:00","content_type":"application/x-liquid","size":208,"checksum":null,"theme_id":828155753},{"key":"assets/bg-footer.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-footer.gif?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/gif","size":1434,"checksum":null,"theme_id":828155753},{"key":"assets/bg-sidebar.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-sidebar.gif?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/gif","size":124,"checksum":null,"theme_id":828155753},{"key":"assets/bg-body-orange.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-body-orange.gif?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/gif","size":1548,"checksum":null,"theme_id":828155753},{"key":"templates/collection.liquid","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":946,"checksum":null,"theme_id":828155753},{"key":"assets/sidebar-menu.jpg","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/sidebar-menu.jpg?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/jpeg","size":1609,"checksum":null,"theme_id":828155753},{"key":"templates/cart.liquid","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":2028,"checksum":null,"theme_id":828155753},{"key":"config/settings_data.json","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/json","size":1471,"checksum":null,"theme_id":828155753},{"key":"templates/index.liquid","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":1108,"checksum":null,"theme_id":828155753},{"key":"assets/bg-body.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-body.gif?v=1278963110","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"image/gif","size":1571,"checksum":null,"theme_id":828155753}]}
  ```

***

## getRetrieves a single asset for a theme

[theme](https://shopify.dev/docs/api/admin-graphql/latest/queries/theme?example=retrieves-a-single-asset-for-a-theme)

Retrieves a single asset for a theme by its key.

To retrieve a single asset, include `asset[key]=#{asset_key}` as a request parameter. For example, to retrieve the asset with a key of `templates/index.liquid`, the request might be `/admin/themes/828155753/assets.json?asset[key]=templates/index.liquid`.

For more information on the `key` property, refer to Asset properties.

### Parameters

***

api\_version

**string**

**required**

***

asset\[key]

**required**

**≤ 100**

Retrieves a single asset for a theme by specifying the asset's key.

***

theme\_id

**string**

**required**

***

fields

Specify which fields to show using a comma-separated list of field names.

***

### Examples

### Retrieve a Liquid template

### Query parameters

asset\[key]=​templates/index.liquid

**required**

**≤ 100**

Retrieves a single asset for a theme by specifying the asset's key.

get

## /admin/api/2026-07/themes/828155753/assets.​json?asset\[key]=​templates/index.liquid

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json?asset%5Bkey%5D=templates%2Findex.liquid" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "asset": {
    "key": "templates/index.liquid",
    "public_url": null,
    "value": "<!-- LIST 3 PER ROW -->\n<h2>Featured Products</h2>\n<table id=\"products\" cellspacing=\"0\" cellpadding=\"0\">\n  {% tablerow product in collections.frontpage.products cols:3 %}\n    <a href=\"{{product.url}}\">{{ product.featured_image | product_img_url: 'small' | img_tag }}</a>\n    <h3><a href=\"{{product.url}}\">{{product.title}}</a></h3>\n    <ul class=\"attributes\">\n      <li><span class=\"money\">{{product.price_min | money}}</span></li>\n    </ul>\n  {% endtablerow %}\n</table>\n<!-- /LIST 3 PER ROW -->\n\n{{ content_for_index }}\n\n<div id=\"articles\">\n  {% assign article = pages.frontpage %}\n  <div class=\"article\">\n    {% if article.content != \"\" %}\n      <h3>{{ article.title }}</h3>\n      <div class=\"article-body textile\">\n        {{ article.content }}\n      </div>\n    {% else %}\n      <div class=\"article-body textile\">\n        In <em>Admin > Blogs & Pages</em>, create a page with the handle <strong><code>frontpage</code></strong> and it will show up here.\n        <br />\n        {{ \"Learn more about handles\" | link_to: \"http://wiki.shopify.com/Handle\" }}\n      </div>\n    {% endif %}\n  </div>\n</div>\n",
    "created_at": "2010-07-12T15:31:50-04:00",
    "updated_at": "2010-07-12T15:31:50-04:00",
    "content_type": "application/x-liquid",
    "size": 1108,
    "checksum": null,
    "theme_id": 828155753
  }
}
```

### examples

* #### Retrieve a Liquid template

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json?asset%5Bkey%5D=templates%2Findex.liquid" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"asset":{"key":"templates/index.liquid","public_url":null,"value":"<!-- LIST 3 PER ROW -->\n<h2>Featured Products</h2>\n<table id=\"products\" cellspacing=\"0\" cellpadding=\"0\">\n  {% tablerow product in collections.frontpage.products cols:3 %}\n    <a href=\"{{product.url}}\">{{ product.featured_image | product_img_url: 'small' | img_tag }}</a>\n    <h3><a href=\"{{product.url}}\">{{product.title}}</a></h3>\n    <ul class=\"attributes\">\n      <li><span class=\"money\">{{product.price_min | money}}</span></li>\n    </ul>\n  {% endtablerow %}\n</table>\n<!-- /LIST 3 PER ROW -->\n\n{{ content_for_index }}\n\n<div id=\"articles\">\n  {% assign article = pages.frontpage %}\n  <div class=\"article\">\n    {% if article.content != \"\" %}\n      <h3>{{ article.title }}</h3>\n      <div class=\"article-body textile\">\n        {{ article.content }}\n      </div>\n    {% else %}\n      <div class=\"article-body textile\">\n        In <em>Admin > Blogs & Pages</em>, create a page with the handle <strong><code>frontpage</code></strong> and it will show up here.\n        <br />\n        {{ \"Learn more about handles\" | link_to: \"http://wiki.shopify.com/Handle\" }}\n      </div>\n    {% endif %}\n  </div>\n</div>\n","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2010-07-12T15:31:50-04:00","content_type":"application/x-liquid","size":1108,"checksum":null,"theme_id":828155753}}
  ```

***

## putCreates or updates an asset for a theme

[themeFilesUpsert](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeFilesUpsert)

[themeFilesCopy](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeFilesCopy?example=creates-or-updates-an-asset-for-a-theme)

Creates or updates an asset for a theme.

In the PUT request, you can include the `src` or `source_key` property to create the asset from an existing file.

### Parameters

***

api\_version

**string**

**required**

***

theme\_id

**string**

**required**

***

source\_key

The path within the theme to an existing asset. Include in the body of the PUT request to create a duplicate asset.

***

src

The source URL of an image. Include in the body of the PUT request to upload the image to Shopify.

***

### Examples

### Change an existing Liquid template's value

### Path parameters

theme\_​id=​828155753

**string**

**required**

### Request body

asset​

**Asset resource**

asset.key:​"templates/index.liquid"

->[filename](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OnlineStoreThemeFilesUpsertFileInput#fields-filename)

The path to the asset within a theme. It consists of the file's directory and filename. For example, the asset `assets/bg-body-green.gif` is in the **assets** directory, so its key is `assets/bg-body-green.gif`.

asset.value:​"\<img src='backsoon-postit.png'>\<p>We are busy updating the store for you and will be back within the hour.\</p>"

->[value](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OnlineStoreThemeFileBodyInput#fields-value)

The text content of the asset, such as the HTML and Liquid markup of a template file.

### Create an image asset by providing a base64-encoded attachment

### Path parameters

theme\_​id=​828155753

**string**

**required**

### Request body

asset​

**Asset resource**

asset.key:​"assets/empty.gif"

->[filename](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OnlineStoreThemeFilesUpsertFileInput#fields-filename)

The path to the asset within a theme. It consists of the file's directory and filename. For example, the asset `assets/bg-body-green.gif` is in the **assets** directory, so its key is `assets/bg-body-green.gif`.

asset.attachment:​"R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\n"

->[value](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OnlineStoreThemeFileBodyInput#fields-value)

A base64-encoded image.

### Create an image asset by providing a source URL from which to upload the image

### Path parameters

theme\_​id=​828155753

**string**

**required**

### Request body

asset​

**Asset resource**

asset.key:​"assets/bg-body.gif"

->[filename](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OnlineStoreThemeFilesUpsertFileInput#fields-filename)

The path to the asset within a theme. It consists of the file's directory and filename. For example, the asset `assets/bg-body-green.gif` is in the **assets** directory, so its key is `assets/bg-body-green.gif`.

### Duplicate an existing asset by providing a source key

### Path parameters

theme\_​id=​828155753

**string**

**required**

### Request body

asset​

**Asset resource**

asset.key:​"layout/alternate.liquid"

->[filename](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OnlineStoreThemeFilesUpsertFileInput#fields-filename)

The path to the asset within a theme. It consists of the file's directory and filename. For example, the asset `assets/bg-body-green.gif` is in the **assets** directory, so its key is `assets/bg-body-green.gif`.

put

## /admin/api/2026-07/themes/828155753/assets.​json

```bash
curl -d '{"asset":{"key":"templates/index.liquid","value":"<img src='backsoon-postit.png'><p>We are busy updating the store for you and will be back within the hour.</p>"}}' \
-X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "asset": {
    "key": "templates/index.liquid",
    "public_url": null,
    "created_at": "2010-07-12T15:31:50-04:00",
    "updated_at": "2026-07-02T10:36:21-04:00",
    "content_type": "application/x-liquid",
    "size": 110,
    "checksum": "cd71db2e14df976c8aa44b44c8dae77b",
    "theme_id": 828155753
  }
}
```

### examples

* #### Change an existing Liquid template's value

  #####

  ```curl
  curl -d '{"asset":{"key":"templates/index.liquid","value":"<img src='backsoon-postit.png'><p>We are busy updating the store for you and will be back within the hour.</p>"}}' \
  -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"asset":{"key":"templates/index.liquid","public_url":null,"created_at":"2010-07-12T15:31:50-04:00","updated_at":"2026-07-02T10:36:21-04:00","content_type":"application/x-liquid","size":110,"checksum":"cd71db2e14df976c8aa44b44c8dae77b","theme_id":828155753}}
  ```

* #### Create an image asset by providing a base64-encoded attachment

  #####

  ```curl
  curl -d '{"asset":{"key":"assets/empty.gif","attachment":"R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\n"}}' \
  -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

* #### Create an image asset by providing a source URL from which to upload the image

  #####

  ```curl
  curl -d '{"asset":{"key":"assets/bg-body.gif","src":"http://example.com/new_bg.gif"}}' \
  -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

* #### Duplicate an existing asset by providing a source key

  #####

  ```curl
  curl -d '{"asset":{"key":"layout/alternate.liquid","source_key":"layout/theme.liquid"}}' \
  -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

***

## delDeletes an asset from a theme

[themeFilesDelete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/themeFilesDelete?example=deletes-an-asset-from-a-theme)

Deletes an asset from a theme.

### Parameters

***

api\_version

**string**

**required**

***

asset\[key]

**required**

**≤ 100**

Deletes a single asset from a theme by specifying the asset's key.

***

theme\_id

**string**

**required**

***

### Examples

### Delete an image from a theme

### Query parameters

asset\[key]=​assets/bg-body.gif

**required**

**≤ 100**

Deletes a single asset from a theme by specifying the asset's key.

### Deleting an asset required by the theme fails with an error

### Query parameters

asset\[key]=​layout/theme.liquid

**required**

**≤ 100**

Deletes a single asset from a theme by specifying the asset's key.

del

## /admin/api/2026-07/themes/828155753/assets.​json?asset\[key]=​assets/bg-body.gif

```bash
curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json?asset%5Bkey%5D=assets%2Fbg-body.gif" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "message": "assets/bg-body.gif was successfully deleted"
}
```

### examples

* #### Delete an image from a theme

  #####

  ```curl
  curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json?asset%5Bkey%5D=assets%2Fbg-body.gif" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"message":"assets/bg-body.gif was successfully deleted"}
  ```

* #### Deleting an asset required by the theme fails with an error

  #####

  ```curl
  curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/themes/828155753/assets.json?asset%5Bkey%5D=layout%2Ftheme.liquid" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 403 Forbidden{"message":"layout/theme.liquid could not be deleted"}
  ```
