> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ: UX Toolkit Theme Uploads

> Answers to common questions about overwriting, limits, retrieving, deleting, and securing theme uploads for UX Toolkit.

This article answers common questions about uploading themes to UX Toolkit through the `POST /api/v1/theme` endpoint.
If your question isn't covered here, contact your Marqeta Account Manager.

For the full theming workflow, see [Customizing UX Toolkit](https://www.marqeta.com/docs/developer-guides/uxt-customizing-ux-toolkit.md#themes).

## Does uploading a theme with the same name overwrite the existing theme?

**Yes. A repeat `POST /api/v1/theme` request with an existing `theme_name` replaces the stored theme in both sandbox and production.**

The upload replaces the theme's JSON in full; it doesn't merge the new JSON with the old.
Keep the following in mind:

* **Environments are separate:** Sandbox and production each store their own themes.
  Uploading a theme to one environment doesn't change the theme with the same name in the other.
* **Reserved name:** You can't use `default` as a theme name.
  The Marqeta platform rejects the request.
  Choose a different name for your custom theme.
* **Updates might not appear immediately:** UX Toolkit saves themes after it loads them, so a page might continue to show the previous version after you overwrite a theme.
  To load the latest version on a running page, call `window.marqeta.updateTheme()` with `{ force: true }`.
  For details, see [Switching themes after bootstrap](https://www.marqeta.com/docs/developer-guides/uxt-customizing-ux-toolkit.md#switching-themes-after-bootstrap).

## Are there limits on theme JSON size, theme count, or request rate?

**Yes. The request body is limited to 100 KB, and theme names are limited to 32 characters.**

The following table lists the limits that apply to `POST /api/v1/theme` requests:

| **Limit** | **Value** |
| :- | :- |
| Request body size | 100 KB for the entire request body, including the `theme_name` and the theme JSON. The Marqeta platform rejects larger requests. |
| Theme name length | 1–32 characters. |
| Number of themes | No limit on the number of themes in a card program. Each theme must have a unique name. |
| Request rate | Marqeta doesn't publish a request rate limit for `POST /api/v1/theme`. Don't build your integration to depend on unlimited requests. |

## Is there an endpoint to read or delete a theme?

**No. The Marqeta platform doesn't provide an endpoint you can use to read or delete a theme.**

You can create a theme and overwrite it, but you can't retrieve or remove a theme after you upload it.
The platform also doesn't keep a version history of your theme's JSON.

Keep a copy of every theme's source JSON in your source control repository.
To edit a theme, paste your saved JSON into [Studio](https://studio.ux-toolkit.marqeta.com/), make your changes, and upload the result under the same name to overwrite the existing theme.

## Can I get an access token that is limited to uploading themes?

**Not currently. Uploading a theme requires an access token with the `customer:all` scope.**

The Marqeta platform rejects tokens with a narrower scope.
Because `customer:all` isn't specific to themes, it grants more access than theme upload alone.

If you need credentials limited to uploading themes, contact your Marqeta Account Manager to discuss your requirements.


## Related topics

- [UX Toolkit Release Notes](https://www.marqeta.com/docs/developer-guides/ux-toolkit-release-notes.md)
- [Customizing UX Toolkit](https://www.marqeta.com/docs/developer-guides/uxt-customizing-ux-toolkit.md)
- [About UX Toolkit](https://www.marqeta.com/docs/developer-guides/about-ux-toolkit.md)
- [UX Toolkit Overview](https://www.marqeta.com/docs/core-api/uxt-sdk.md)
- [Upload theme object](https://www.marqeta.com/docs/core-api/uxt-sdk/upload-theme-object.md)
