From 76fefa4c1ef051e74f2b762d84ede99d40571ef6 Mon Sep 17 00:00:00 2001
From: Camila Dziubat <117546561+CamilaDziubat@users.noreply.github.com>
Date: Sat, 17 Jan 2026 23:03:21 -0300
Subject: [PATCH] Common issues and troubleshooting

---
 ...or-private-contributions-and-achievements.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/content/account-and-profile/how-tos/contribution-settings/manage-visibility-settings-for-private-contributions-and-achievements.md b/content/account-and-profile/how-tos/contribution-settings/manage-visibility-settings-for-private-contributions-and-achievements.md
index 9970ddce03c9..3c24432937b8 100644
--- a/content/account-and-profile/how-tos/contribution-settings/manage-visibility-settings-for-private-contributions-and-achievements.md
+++ b/content/account-and-profile/how-tos/contribution-settings/manage-visibility-settings-for-private-contributions-and-achievements.md
@@ -19,6 +19,23 @@ shortTitle: Private contributions {% ifversion hide-individual-achievements %}an
 allowTitleToDifferFromFilename: true
 contentType: how-tos
 ---
+## Common issues and troubleshooting
+
+### Achievements are enabled but not visible
+If achievements are enabled in your profile settings but do not appear:
+- Make sure your profile is public
+- Verify that the achievement was earned through public activity
+- Allow some time for GitHub to update your profile, as changes may not appear immediately
+
+### Private contributions and achievements
+Private contributions may appear in the contribution graph when enabled, but they do not count toward profile achievements. Achievements are only earned through public activity.
+
+### Organization and internal repositories
+Contributions made in internal or organization-owned repositories may not always count toward achievements, depending on repository visibility and organization settings.
+
+### Deprecated achievements
+Some achievements were available only during limited-time events (such as Arctic Code Vault or Mars 2020 Contributor) and can no longer be earned.
+---
 
 ## Changing the visibility of your private contributions