---
title: >-
  Introducing theme and theme file management in the Admin GraphQL API - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/introducing-theme-and-theme-file-management-in-the-admin-graphql-api
  md: >-
    https://shopify.dev/changelog/introducing-theme-and-theme-file-management-in-the-admin-graphql-api.md
metadata:
  effectiveApiVersion: 2024-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2024-09-25T14:31:34-04:00'
  postedAt: '2024-09-30T10:08:00-04:00'
  updatedAt: '2024-09-30T10:12:40-04:00'
  effectiveAt: '2024-09-30T10:08:00-04:00'
---

September 30, 2024

Tags:

* Admin GraphQL API
* 2024-10

# Introducing theme and theme file management in the Admin GraphQL API

As of API version 2024-10, you can use the admin API to manage Online Store Themes. This feature provides parity with our REST API for managing themes and theme files.

# What's New

## New queries:

* `theme` to query an individual theme by ID
* `themes` to query many themes by role or name

`OnlineStoreTheme` objects expose a `files` query which can be used to fetch the metadata and content of files in a theme. Multiple files can be requested at once, speeding up operations that need to fetch many files.

## New mutations for themes:

* `themeCreate` - upload a new theme
* `themeDelete` - delete an unpublished theme
* `themePublish` - publish a theme
* `themeUpdate` - update the name of a theme

## New mutations for theme files:

* `themeFilesCopy` - copy files from one location to another
* `themeFilesDelete` - delete files in a theme
* `themeFilesUpsert` - write data to files in a theme

Learn more about these changes on [Shopify.dev](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/OnlineStoreTheme)