---
title: "Publish to Staging"
slug: "publish-to-staging"
description: "stage"
updated: 2025-03-17T12:42:01Z
published: 2025-03-17T12:42:01Z
stale: true
---

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

# Publish to Staging

## Overview

Publish to Staging provides a way to validate an updated site configuration before publishing it to production.

After publishing to stage, you can direct requests to the staging network by editing the host file on your local machine. [Learn how.](https://docs.qwilt.com/v1/docs/publish-to-staging#direct-traffic-to-the-site)

When you're satisfied with the site configuration on staging, you can then publish it to production.

Publishing to staging does not affect traffic in production.

## Limitations

- **Routing**: Traditional routing to the staging environment is not available. To direct traffic to this site, in your host file, map the site hostname to the staging environment IP address. [Learn how.](https://docs.qwilt.com/v1/docs/publish-to-staging#direct-traffic-to-the-site)
- **Single server deployment** - The staging environment runs on a single server with limited capacity. This should be factored into testing.
- **No SLA provided** - Service Level Agreements (SLAs) do not apply to the staging environment. Uptime, availability, and response times are not guaranteed.
- **Not for performance or stress testing** - Staging is not suitable for performance or stress testing and does not replicate production performance.
- **Limited geographic coverage** - Staging operates in a single geographic region, which may introduce latency and network conditions not representative of global production conditions.
- **Configuration and functional validation only** - Staging is designed for site configuration and functional validation, not for load testing or production readiness.
- **Purge functionality** - Purge is not supported via the UI but is available via the API.
- **Observability**: Requests to the staging network are not captured in the media delivery logs, or Qwilt reports and dashboards.
- **Need more robust support?** If your project requires more comprehensive testing, please contact your account team to explore alternatives.

## Publish a Site to Staging

**To publish a site version to staging:**

1. Make sure the site you want to publish is saved. See [Save a Site Configuration](/v1/docs/save-a-site-configuration).
2. Select **Publish** and then **Staging**.  

![image.png](https://cdn.document360.io/fa039225-513b-46a1-ba78-a57a1f1cb7c6/Images/Documentation/image%2852%29.png)
3. See [Publish a Site](/v1/docs/publish-a-site) for further instruction.

          
          

Alternatively, use the [Sites API](https://api-docs.qwilt.cqloud.com/docs/CDN%20APIs/Sites%20API/sites-api-reference) to publish a specified configuration version to staging. Simply set the *target* attribute to *staging*.

## Direct Traffic to the Site

To direct requests to the site on staging, edit the host file on your local machine to map the site hostname to this static IP: **35.234.109.253**.

For example, if the site hostname is *www.example.com*, add the following line to the host file on your local computer:

`35.234.109.253 www.example.com`

In this example, an API request from the local machine to *www.example.com* would be directed to the staging server at *35.234.109.253* rather than to the production server.

## Markers in the Site Configuration UI

Purple markers throughout the Site Configuration UI identify versions that are (or were) published to staging:

![publish2StagingPurpleMarkers2.png](https://cdn.document360.io/fa039225-513b-46a1-ba78-a57a1f1cb7c6/Images/Documentation/publish2StagingPurpleMarkers2.png)

![purpleMarkersVersionsList.png](https://cdn.document360.io/fa039225-513b-46a1-ba78-a57a1f1cb7c6/Images/Documentation/purpleMarkersVersionsList.png)

In the Publish History, each publishing operation in the list specifies the target of the publishing operation, production or staging. The purple/green background indicates an active publish version in production/staging.

![stagingInPublishHistory.png](https://cdn.document360.io/fa039225-513b-46a1-ba78-a57a1f1cb7c6/Images/Documentation/stagingInPublishHistory.png)

## Linked Certificates

When a site is published, the linked certificate is published along with it, regardless of the publishing target.

## Purge

Currently, you can use the [Purge API](https://api-docs.qwilt.cqloud.com/docs/CDN%20APIs/Purge%20API/purge-api-start-here) to run a Purge operation on the Staging network.

Simply set the *purgeTarget* attribute to *staging*.