Retry a failed publish or deployment
When a publish or deployment trigger fails, retry it safely from the project Publishing area. A retry re-runs readiness checks first, so it will not commit unready content.
If a publish or its deployment trigger does not complete, the item becomes Failed and the job can be retried. Acrosite makes retrying safe: it re-runs the readiness checks first. This guide covers retrying and recovering.
Who this is for
Owners, Admins, and Developers, who resolve a failed or stuck publish.
Before you start
- You have read the failed job in Publish Logs and know which stage failed.
- You have fixed the cause — see Troubleshoot publishing failures.
Find the failed job
- Open the project's Publishing area.
- Open the Failed Jobs tab.
- Each failed job shows the error summary under its title; select the title to open the item.
Retry safely
Once you have fixed the cause:
- Retry the publish from the project Publishing area. A retry re-runs Acrosite's readiness checks before doing anything, so it will not commit content that is not ready.
- If only the deployment trigger failed, you can retry just the deployment without recommitting — the content is already in your repository.
- After a retry, confirm the new attempt in Publish Logs and the deployment in Deployment Logs.
Important
A failed deployment trigger does not undo the commit. Your content is already committed; you only need the redeploy to fire. "Deployment triggered" means Acrosite requested a rebuild — confirm the finished build in your provider's dashboard.
If it keeps failing
If a job keeps failing after you have fixed the obvious causes, work through Troubleshoot publishing failures, which covers GitHub commit, deployment trigger, validation, and plan-limit causes in order.
Next steps
Frequently asked questions
Yes. A retry re-runs Acrosite's readiness checks first, so it will not commit content that is not ready. Fix the cause the log points to, then retry.
No. If the commit succeeded but the deployment trigger failed, you can retry just the deployment. Your content is already in the repository, so you only need the redeploy to fire.
Check Publish Logs for the new attempt and Deployment Logs for the deployment trigger response. Remember that a successful trigger means your provider accepted the request — confirm the finished build in your provider's dashboard.