We couldn't find the page you were looking for.
\nfrontpage and it will show up here.\n frontpage and it will show up here.\n 
\We are busy updating the store for you and will be back within the hour.\
" ->[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-01/themes/828155753/assets.json ```bash curl -d '{"asset":{"key":"templates/index.liquid","value":"We are busy updating the store for you and will be back within the hour.
"}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-01/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-01-09T22:35:59-05: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":"We are busy updating the store for you and will be back within the hour.
"}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-01/themes/828155753/assets.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` ##### ```remix const { admin, session } = await authenticate.admin(request); const asset = new admin.rest.resources.Asset({session: session}); asset.theme_id = 828155753; asset.key = "templates/index.liquid"; asset.value = "We are busy updating the store for you and will be back within the hour.
"; await asset.save({ update: true, }); ``` ##### ```ruby # Session is activated via Authentication test_session = ShopifyAPI::Context.active_session asset = ShopifyAPI::Asset.new(session: test_session) asset.theme_id = 828155753 asset.key = "templates/index.liquid" asset.value = "We are busy updating the store for you and will be back within the hour.
" asset.save! ``` ##### ```node // Session is built by the OAuth process const asset = new shopify.rest.Asset({session: session}); asset.theme_id = 828155753; asset.key = "templates/index.liquid"; asset.value = "We are busy updating the store for you and will be back within the hour.
"; await asset.save({ update: true, }); ``` #### 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-01-09T22:35:59-05: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-01/themes/828155753/assets.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` ##### ```remix const { admin, session } = await authenticate.admin(request); const asset = new admin.rest.resources.Asset({session: session}); asset.theme_id = 828155753; asset.key = "assets/empty.gif"; asset.attachment = "R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\n"; await asset.save({ update: true, }); ``` ##### ```ruby # Session is activated via Authentication test_session = ShopifyAPI::Context.active_session asset = ShopifyAPI::Asset.new(session: test_session) asset.theme_id = 828155753 asset.key = "assets/empty.gif" asset.attachment = "R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\n" asset.save! ``` ##### ```node // Session is built by the OAuth process const asset = new shopify.rest.Asset({session: session}); asset.theme_id = 828155753; asset.key = "assets/empty.gif"; asset.attachment = "R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\n"; await asset.save({ update: true, }); ``` #### response ```json HTTP/1.1 200 OK{"asset":{"key":"assets/empty.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/empty.gif?v=1768016162","created_at":"2026-01-09T22:36:02-05:00","updated_at":"2026-01-09T22:36:02-05:00","content_type":"image/gif","size":43,"checksum":"45cf913e5d9d3c9b2058033056d3dd23","theme_id":828155753}} ``` * #### 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-01/themes/828155753/assets.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` ##### ```remix const { admin, session } = await authenticate.admin(request); const asset = new admin.rest.resources.Asset({session: session}); asset.theme_id = 828155753; asset.key = "assets/bg-body.gif"; asset.src = "http://example.com/new_bg.gif"; await asset.save({ update: true, }); ``` ##### ```ruby # Session is activated via Authentication test_session = ShopifyAPI::Context.active_session asset = ShopifyAPI::Asset.new(session: test_session) asset.theme_id = 828155753 asset.key = "assets/bg-body.gif" asset.src = "http://example.com/new_bg.gif" asset.save! ``` ##### ```node // Session is built by the OAuth process const asset = new shopify.rest.Asset({session: session}); asset.theme_id = 828155753; asset.key = "assets/bg-body.gif"; asset.src = "http://example.com/new_bg.gif"; await asset.save({ update: true, }); ``` #### response ```json HTTP/1.1 200 OK{"asset":{"key":"assets/bg-body.gif","public_url":"https://cdn.shopify.com/s/files/1/0005/4838/0009/t/1/assets/bg-body.gif?v=1768016157","created_at":"2010-07-12T15:31:50-04:00","updated_at":"2026-01-09T22:35:57-05:00","content_type":"image/gif","size":43,"checksum":"45cf913e5d9d3c9b2058033056d3dd23","theme_id":828155753}} ``` * #### 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-01/themes/828155753/assets.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` ##### ```remix const { admin, session } = await authenticate.admin(request); const asset = new admin.rest.resources.Asset({session: session}); asset.theme_id = 828155753; asset.key = "layout/alternate.liquid"; asset.source_key = "layout/theme.liquid"; await asset.save({ update: true, }); ``` ##### ```ruby # Session is activated via Authentication test_session = ShopifyAPI::Context.active_session asset = ShopifyAPI::Asset.new(session: test_session) asset.theme_id = 828155753 asset.key = "layout/alternate.liquid" asset.source_key = "layout/theme.liquid" asset.save! ``` ##### ```node // Session is built by the OAuth process const asset = new shopify.rest.Asset({session: session}); asset.theme_id = 828155753; asset.key = "layout/alternate.liquid"; asset.source_key = "layout/theme.liquid"; await asset.save({ update: true, }); ``` #### response ```json HTTP/1.1 200 OK{"asset":{"key":"layout/alternate.liquid","public_url":null,"created_at":"2026-01-09T22:36:01-05:00","updated_at":"2026-01-09T22:36:01-05:00","content_type":"application/x-liquid","size":3049,"checksum":"1879a06996941b2ff1ff485a1fe60a97","theme_id":828155753}} ``` *** ## 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-01/themes/828155753/assets.json?asset\[key]=assets/bg-body.gif ```bash curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-01/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-01/themes/828155753/assets.json?asset%5Bkey%5D=assets%2Fbg-body.gif" \ -H "X-Shopify-Access-Token: {access_token}" ``` ##### ```remix await admin.rest.resources.Asset.delete({ session: session, theme_id: 828155753, asset: {"key": "assets/bg-body.gif"}, }); ``` ##### ```ruby # Session is activated via Authentication test_session = ShopifyAPI::Context.active_session ShopifyAPI::Asset.delete( session: test_session, theme_id: 828155753, asset: {"key" => "assets/bg-body.gif"}, ) ``` ##### ```node // Session is built by the OAuth process await shopify.rest.Asset.delete({ session: session, theme_id: 828155753, asset: {"key": "assets/bg-body.gif"}, }); ``` #### 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-01/themes/828155753/assets.json?asset%5Bkey%5D=layout%2Ftheme.liquid" \ -H "X-Shopify-Access-Token: {access_token}" ``` ##### ```remix await admin.rest.resources.Asset.delete({ session: session, theme_id: 828155753, asset: {"key": "layout/theme.liquid"}, }); ``` ##### ```ruby # Session is activated via Authentication test_session = ShopifyAPI::Context.active_session ShopifyAPI::Asset.delete( session: test_session, theme_id: 828155753, asset: {"key" => "layout/theme.liquid"}, ) ``` ##### ```node // Session is built by the OAuth process await shopify.rest.Asset.delete({ session: session, theme_id: 828155753, asset: {"key": "layout/theme.liquid"}, }); ``` #### response ```json HTTP/1.1 403 Forbidden{"message":"layout/theme.liquid could not be deleted"} ```