diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 6c6c71f3e5..575a5b770c 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -8,6 +8,9 @@ assignees: ''
 ---
 
 **Describe the bug**
+
+Note: Please check some common questiosn on https://block.github.io/goose/docs/troubleshooting before filing the report
+
 A clear and concise description of what the bug is.
 
 **To Reproduce**
diff --git a/documentation/docs/troubleshooting.md b/documentation/docs/troubleshooting.md
index 5ada85bcd4..6840966843 100644
--- a/documentation/docs/troubleshooting.md
+++ b/documentation/docs/troubleshooting.md
@@ -177,7 +177,8 @@ An example is the GitHub extension whose command is `npx -y @modelcontextprotoco
 
 ### macOS Permission Issues
 
-If you encounter an issue where the Goose Desktop app shows no window on launch, it may be due to file and folder permissions. This typically happens because Goose needs read and write access to the `~/.config` directory to create its log directory and file.
+If you encounter an issue where the Goose Desktop app shows no window on launch, it may be due to file and folder permissions. This typically happens because Goose needs read and write access to the `~/.config` directory to create its log directory and file. 
+Similarly, if tools fail to create files or directories during use, it could be caused by the same permission issue.
 
 #### How to Check and Fix Permissions:
 
@@ -216,6 +217,11 @@ sudo /Applications/Goose.app/Contents/MacOS/Goose
 :::note
 Running Goose with sudo may create files owned by root, which could lead to further permission issues. Use this as a troubleshooting step rather than a permanent fix.
 :::
+
+#### Update permission in System Settings (macOs)
+1. Go to `System Settings` -> `Privacy & Security` -> `Files & Folders`
+2. Grant Goose access
+
 ---
 
 ### Connection Error with Ollama Provider on WSL