Blueprints: Official GitHub Actions for Blueprints

We're excited to announce official GitHub Actions for Sanity Blueprints, making it easier than ever to automate your Blueprint deployments and review changes in your CI/CD pipeline. As part of this update, we’ve also removed the personal auth token limitation. You can now officially deploy your blueprint stacks with robot tokens.

New actions

Deploy Action

Automatically deploy your Sanity Blueprints to your project or organization directly from GitHub Actions. Perfect for continuous deployment workflows that trigger on merges to main or specific branches.

name: Deploy Sanity Blueprints

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Deploy blueprints
        uses: sanity-io/blueprints-actions/deploy@deploy-v2
        with:
          sanity-token: ${{ secrets.SANITY_TOKEN }}
          stack-id: 'ST_1234xyz'
          project-id: '1234xyz'

Plan Action

Preview Blueprint changes before they're deployed. This action analyzes your changes and automatically posts (or updates) a comment on your pull requests showing exactly what resources will be created, updated, or deleted.

name: Sanity Blueprints Plan

on:
  pull_request:

permissions:
  contents: read
  pull-requests: write  # Required for posting comments

jobs:
  plan:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Plan blueprints changes
        uses: sanity-io/blueprints-actions/plan@plan-v1
        with:
          sanity-token: ${{ secrets.SANITY_TOKEN }}
          stack-id: 'ST_1234xyz'
          project-id: '1234xyz'

The plan action comment gives you a preview of what to expect when prior to deployment.

Get started

Check out the new guide to set up the actions and start building your workflows. For questions and support, visit the Sanity community or open an issue in the repository.