diff --git a/.github/workflows/mkdocs.yml b/.github/workflows/mkdocs.yml
index 0177f1f4f1b0..d3a3ba7be8f6 100644
--- a/.github/workflows/mkdocs.yml
+++ b/.github/workflows/mkdocs.yml
@@ -5,6 +5,11 @@ on:
       - main
   workflow_dispatch:
 
+permissions:
+  contents: write
+  deployments: write
+  pages: write
+
 jobs:
   build:
     name: Publish Contributor GitHub Pages
diff --git a/mkdocs.yml b/mkdocs.yml
index 0f23c3707fd1..d5bfcba7b0d4 100755
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -9,6 +9,8 @@ edit_uri: "https://github.com/hashicorp/terraform-provider-azurerm/tree/main/con
 docs_dir: contributing
 site_dir: site
 
+remote_branch: main-gh-pages
+
 dev_addr: 127.0.0.1:47000
 
 nav: