# Backplates

URL: https://docs.glossi.io/library/backplates

Photos your workspace places behind the product on the Color stage in Studio.

The Backplates page holds the photos you put behind a product on the Color stage in Studio. Open **Library → Backplates**, or go to [`/library/backplates`](https://app.glossi.io/library/backplates).

To use one, open the background controls on the Color stage in Studio, set **Type** to **Image**, pick a backplate, and choose **Fill** or **Fit** under **Framing**. You can also upload a new backplate from that picker. See [Background](https://docs.glossi.io/studio/background.md).

## Upload backplates

Select **Upload backplate**, or drop images anywhere on the page. Each image becomes one backplate.

| Limit      | Value                                                                          |
| ---------- | ------------------------------------------------------------------------------ |
| Formats    | PNG, JPEG, or WebP. WebP is converted to PNG before upload.                    |
| Size       | Up to 100 MB, measured after any conversion.                                   |
| Dimensions | Images with a long edge over 8192 px are scaled down to 8192 px before upload. |

The name comes from the file name. The upload counts toward your workspace's storage, and is refused when the workspace is over its storage limit.

## Find and organize backplates

| Control                 | What it does                                                                      |
| ----------------------- | --------------------------------------------------------------------------------- |
| Search                  | Matches backplate names.                                                          |
| **All** / **Favorites** | Shows every backplate or only the ones you starred.                               |
| Sort                    | **Newest**, **Oldest**, or **Name**.                                              |
| **New folder**          | Backplates use folders. See [Find and organize](https://docs.glossi.io/library/overview.md#find-and-organize). |

Right-click a card for **Favorite**, &#x2A;*Rename...**, &#x2A;*Move to...**, and &#x2A;*Delete...**. Select several to move or delete them together.

## Open a backplate

Selecting a card opens a panel with the image, its status, its size in pixels, the date it was added, its [property](https://docs.glossi.io/set-up-the-product/properties.md) values, and its asset ID.

## Delete a backplate

Before you confirm, the dialog shows where the backplate is used: projects, templates, renders in progress, and a count of uses in other workspaces. Deleting removes it from your library. Projects and templates that already use it keep it until someone changes their background. Glossi deletes the file itself later, once nothing uses it.

## Upload through the API

The REST API has the same collection at `/api/v1/backplates`: create upload URLs, confirm, list, check status and usage, rename, and delete. The API accepts PNG and JPEG only, up to 100 MB with a long edge of at most 8192 px, and does not convert or resize. API access is available on Enterprise. See [Get started with the API](https://docs.glossi.io/api/getting-started.md).

## Related

* [Background](https://docs.glossi.io/studio/background.md)
* [Templates](https://docs.glossi.io/library/templates.md)
* [Properties](https://docs.glossi.io/set-up-the-product/properties.md)