---
title: Optional role argument for themeCreate mutation - 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/optional-role-argument-for-theme-create-mutation
  md: >-
    https://shopify.dev/changelog/optional-role-argument-for-theme-create-mutation.md
metadata:
  effectiveApiVersion: 2025-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-01-22T14:31:14-05:00'
  postedAt: '2025-01-23T12:00:00-05:00'
  updatedAt: '2025-02-07T16:45:55-05:00'
  effectiveAt: '2025-01-23T12:00:00-05:00'
---

January 23, 2025

Tags:

* Admin GraphQL API
* 2025-04

# Optional `role` argument for `themeCreate` mutation

We've added an optional [`role` argument](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/themeCreate#argument-role) on the `themeCreate` mutation, which allows clients to specify a role for the newly created theme. Only `UNPUBLISHED` and `DEVELOPMENT` roles are permitted for newly created themes.