Pause and resume a project

Pause stops production for a single project. Visitors to production hostnames receive HTTP 503 with code PROJECT_PAUSED. Preview deployments keep serving so you can still share and test builds.

Prerequisites

You need an Owner or Admin role in the workspace. Members can view status but cannot pause or resume.

If the workspace itself is suspended, you cannot pause or resume projects until the suspension is cleared. See Workspace is suspended.

Pause production

1. Open the project in the dashboard.
2. Go to Project settings.
3. Turn on Pause production.
4. Type the project name in the confirmation dialog, then choose Pause production.

The project shows as paused in project lists. Production aliases and custom domains stop serving after the edge picks up the updated CDN manifest.

What happens while paused

While pausedAt is set on the project:

• Production visitors get 503 and response header x-easel-serve-denied: PROJECT_PAUSED.
• Preview hostnames keep working.
• New production deployments and production promote from Git are blocked.
• Preview deployments can still be created.

Workspace suspend overrides pause. If the workspace is suspended, visitors see WORKSPACE_SUSPENDED instead, including on preview. See Workspace is suspended.

Resume production

1. Open Project settings for the paused project.
2. Turn off Pause production.

Production serving and production deploys return after the edge refreshes the manifest.

Edge timing after pause or resume

The edge caches CDN manifests for 30s by default. After you pause or resume, wait up to that TTL before expecting the new serve behavior.

Related guides

• Workspace is suspended: platform-wide deny for every project in the workspace
• Preview and production environments: which URLs pause affects
• Troubleshooting: other edge and DNS failures