Search

Troubleshooting

Fix common errors and unexpected behavior.

Fix a failed publish

3 min read Updated 2026-10-27

Common reasons a build won't publish and how to resolve them.

A failed publish usually points to a configuration or build error.

First, check the Build log on the publish dialog — the failing step is highlighted with the exact error.

The most common cause is a missing environment variable. Confirm all required secrets are set under Settings → Environment.

If the error references a dependency, clear the cache from the same dialog and retry.

Still stuck on this?

Our team is one message away.

Back to Troubleshooting