diff --git a/deploy/github.mdx b/deploy/github.mdx
index 0c2ec57ef..df56d0986 100644
--- a/deploy/github.mdx
+++ b/deploy/github.mdx
@@ -127,7 +127,13 @@ If you encounter problems with the GitHub app, resetting the connection can solv
 
 ### Feedback add-ons are unavailable
 
-If you cannot enable the edit suggestions or raise issues options in your dashboard and your repository is public, revalidate your Git settings.
+The **edit suggestions** and **raise issues** feedback features are only available for public GitHub repositories. These features are automatically disabled for private repositories to protect your source code and internal documentation structure.
+
+<Warning>
+  If your repository is private, you cannot enable edit suggestions or raise issues. This is a security feature, not a configuration issue. Making your repository public will automatically enable these options.
+</Warning>
+
+If your repository is public but you still cannot enable these options, revalidate your Git settings:
 
 <Steps>
   <Step title="Navigate to Git Settings">
@@ -150,4 +156,8 @@ If you cannot enable the edit suggestions or raise issues options in your dashbo
       />
     </Frame>
   </Step>
-</Steps>
\ No newline at end of file
+</Steps>
+
+<Note>
+  When a repository changes from public to private, edit suggestions and raise issues are automatically disabled across all deployments, including preview deployments.
+</Note>
\ No newline at end of file
diff --git a/optimize/feedback.mdx b/optimize/feedback.mdx
index ce9bacf1a..c66f2d308 100644
--- a/optimize/feedback.mdx
+++ b/optimize/feedback.mdx
@@ -51,6 +51,12 @@ The feedback tab displays information according to the [feedback add-ons](https:
 - **Thumbs rating**: Simple thumbs up/down voting to gauge overall satisfaction with pages.
 - **Contextual feedback**: Free form feedback about the content of a page.
 - **Code snippet feedback**: Feedback specifically on code snippets.
+- **Edit suggestions**: Allow users to suggest edits to your documentation directly through GitHub. Only available for public GitHub repositories.
+- **Raise issues**: Allow users to create GitHub issues to report problems or request improvements. Only available for public GitHub repositories.
+
+<Warning>
+  **Edit suggestions** and **raise issues** features are only available for public GitHub repositories. These features are automatically disabled when your repository is private to protect your source code and internal documentation structure.
+</Warning>
 
 <Note>
   If you disable telemetry in your `docs.json` file, feedback features are not available on your documentation pages.