The fact AppVeyor deployment requires build artifacts on input makes deployment process predictable and repeatable.

AppVeyor allows you to deploy using multiple providers as part of the build process (inline deployment) as well as promote builds to existing environments (environment deployment).

Inline deployment runs as the last phase in the build pipeline and allows configuring multiple deployments running synchronously one-by-one with results in build console.

Environment deployment is triggered manually or through API to deploy “green” build to existing environment. A new deployment is registered within a project/environment with results in deployment console. If you don’t have any existing environments, you can create one at

The table below summarizes key differences between two modes with lists of deployment providers available in each mode:

Inline deploymentEnvironment deployment
Deploys local artifact filesDeploys artifacts from cloud storage
Build consoleDeployment console
Do not register deploymentRegister new deployment
Local provider-
-Deployment Agent
Web DeployWeb Deploy
SQL Database (SSDT)SQL Database (SSDT)
Azure WebJobAzure WebJob
Azure BlobAzure Blob
Azure Cloud ServiceAzure Cloud Service
Amazon S3Amazon S3
GitHub ReleasesGitHub Releases

Environment variables in provider settings

You can use standard and custom environment variables in provider settings, for example you can set remote FTP folder as $(appveyor_build_version)\artifacts where $(appveyor_build_version) will be replaced with current build version.

Conditional deployment

When you deploy as part of the build process you can control under which conditions deployment should be run.

By default, AppVeyor deploys from all branches, but you can include only specific branches. Also, you can use any environment variables to have more complex conditions.

For example, to deploy from “master” branch and only artifacts built for “x86” platform (platform is the name of environment variable):

- provider: Environment
  name: production
    branch: master
    platform: x86

Deploy on tag (GitHub and GitLab only)

By default AppVeyor starts a new build on any push to GitHub whether it’s regular commit or a new tag. Repository tagging frequently used to trigger deployment.

AppVeyor sets APPVEYOR_REPO_TAG environment variable to distinguish regular commits from tags - the value is true if tag was pushed; otherwise it’s false. When it’s true the name of tag is stored in APPVEYOR_REPO_TAG_NAME.

You can use APPVEYOR_REPO_TAG variable to trigger deployment on tag only, for example:

- provider: Environment
  name: production
    appveyor_repo_tag: true

However please note that branch and appveyor_repo_tag are mutually exclusive. This is because in case of tag, it replaces branch in webhook content and there are no practically reliable way to recognize from what branch tag was created. Therefore with this setting deployment will happen only for master branch:

- provider: Environment
  name: production
    branch: master # only this will work
    appveyor_repo_tag: true # condition will never be evaluated

So if you need to deploy on both branch and tag, please create two provider sections under deploy like this:

  - provider: Environment
    name: production
      branch: master

  - provider: Environment
    name: production
      appveyor_repo_tag: true

You can disable builds on new tags through UI (General tab of project settings) or in appveyor.yml:

skip_tags: true
Did you know that you can edit this page on GitHub and send us a Pull Request?