> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# `deployment-status`

The status after `vercel deploy` finishes is stored here.

| Type                                                                           | Description                                  |
| ------------------------------------------------------------------------------ | -------------------------------------------- |
| `"QUEUED" \| "BUILDING" \| "ERROR" \| "INITIALIZING" \| "READY" \| "CANCELED"` | The deployment status is stored as a string. |

## Example

```yaml {26,33-34} file="/snippets/references/outputs/deployment-status.yml"
name: Vercel

on:
  push:
    branches: [main]
  pull_request:

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:
  deploy:
    name: Deploy
    runs-on: ubuntu-latest
    permissions:
      contents: read
      deployments: write
      statuses: write
      pull-requests: write

    steps:
      - uses: actions/checkout@v7

      - uses: nexterias/actions-vercel@v2
        id: vercel
        with:
          token: ${{ secrets.VERCEL_TOKEN }}
          org-id: ${{ secrets.VERCEL_ORG_ID }}
          project-id: ${{ secrets.VERCEL_PROJECT_ID }}
          production: ${{ github.ref == 'refs/heads/main' }}

      - name: Print deployment status
        run: echo ${{ steps.vercel.outputs.deployment-status }}

```