Skip to content

Pull request previews

Introduced in v1.12.0

When creating a service from a Git application, pull request previews are enabled by default.
You can manage this behavior in the service’s settings under Auto-deploy options:

Auto-deploy settingsAuto-deploy settings

When a pull request is opened, ZaneOps automatically creates a preview environment for that PR.

The associated Git application will also post a comment on the pull request, updating you on the status of the preview deployment.

PR Preview comments PR Preview comments

When a pull request originates from a forked repository, ZaneOps will create the preview environment but will not automatically trigger its deployment.

The repository owner (or ZaneOps project owner) must approve or decline the preview deployment manually.

Preview deployment blocked GitHub commentPreview deployment blocked GitHub commentPreview deployment blocked UI
  • Check that auto-deploy for pull requests is enabled in your service settings.
  • Ensure the Git app webhook is correctly configured and hasn’t been disabled by your Git provider.
  • If the pull request comes from a fork, the deployment may be waiting for manual approval.
  • The Git app needs write access to post comments.
    Verify that the app has the required permissions under your repository’s installed integrations.
  • Check if commenting is disabled for bots or third-party apps in your repository settings.
  • Make sure the preview was created with "commit_sha": "HEAD" (for branch-based previews).
  • If it was triggered manually with a specific commit SHA, new commits will be ignored.