For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /references/inputs/required/token.md.
  • English
  • token

    Enter the Vercel access token. This input is required.

    Tip

    For information on creating an access token, see this section.

    Caution

    The value specified for token is sensitive. Do not include it in public repositories; use Secrets.

    Example

    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
            with:
              token: ${{ secrets.VERCEL_TOKEN }}
              org-id: ${{ secrets.VERCEL_ORG_ID }}
              project-id: ${{ secrets.VERCEL_PROJECT_ID }}
              production: ${{ github.ref == 'refs/heads/main' }}