From 9084ef1cda937cf6f96828793633e234356a230d Mon Sep 17 00:00:00 2001
From: Gabin Aureche <hello@gabinaureche.com>
Date: Mon, 16 May 2022 16:09:17 +0200
Subject: [PATCH] Document fix for unauthorized push (#752)

Co-authored-by: peaceiris <30958501+peaceiris@users.noreply.github.com>
---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index 0b6e373..b9f2b13 100644
--- a/README.md
+++ b/README.md
@@ -561,6 +561,20 @@ The `GITHUB_TOKEN` has limitations for the first deployment so we have to select
 |---|---|
 | ![](./images/settings_select.jpg) | ![](./images/log_success.jpg) |
 
+If the action fails to push the commit or tag with the following error:
+
+```txt
+/usr/bin/git push origin gh-pages
+remote: Write access to repository not granted.
+fatal: unable to access 'https://github.com/username/repository.git/': The requested URL returned error: 403
+Error: Action failed with "The process '/usr/bin/git' failed with exit code 128"
+```
+
+Navigate to your repository's settings / actions / general and in the "Workflow permissions" section, select "Read and write permissions":
+
+<img width="700" alt="Enabling Read and write permissions to the GITHUB_TOKEN on GitHub Actions" src="https://user-images.githubusercontent.com/30958501/168609359-242f59a9-34c6-4272-9793-d6b2cc823837.png">
+
+
 ### ⭐️ Use the latest and specific release
 
 We recommend you to use the latest and specific release of this action for stable CI/CD.