diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 50d37fe7..633aaaa8 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -5,8 +5,11 @@ on:
     branches:
       - main
 
+permissions:
+  contents: write
+
 jobs:
-  build-and-upload:
+  build-docs:
     name: Build & Upload Artifact
     runs-on: ubuntu-latest
     steps:
@@ -33,3 +36,20 @@ jobs:
         with:
           name: docs
           path: docs/_build
+
+  upload-docs:
+    name: Upload docs to GitHub pages
+    runs-on: ubuntu-latest
+    needs: build-docs
+    steps:
+
+    - uses: actions/checkout@v3
+    - uses: actions/download-artifact@v3
+      with:
+        name: docs
+    - name: Deploy to GitHub Pages
+      uses: JamesIves/github-pages-deploy-action@v4.4.2
+      with:
+        folder: html
+        token: ${{ secrets.DOC_PAT }}
+        repository-name: dstansby/napari-matplotlib.github.io