---
title: "Promotes a variant to become the default"
method: PUT
path: "/api/v1/variants/{variantName}/_promote"
tags: ["Variants"]
---

# Promotes a variant to become the default

`PUT /api/v1/variants/{variantName}/_promote`

Promotes a content variant to replace the default content version. This action makes the variant content live for all users.

## Path parameters

- `variantName` string, required

## Response `200`

Variant promoted successfully

## Other responses

- `400` — Bad request - Invalid variant name
- `401` — Unauthorized - User not authenticated
- `403` — Forbidden - User lacks required permissions
- `404` — Variant not found
- `500` — Internal server error

---

[API](https://skmtc.dev/jostens/apis/dotcms-rest-api.md) · [All operations](https://skmtc.dev/jostens/apis/dotcms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jostens/dotcms-rest-api/revisions/a088fe9f515c/schema)