diff --git a/content/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces.md b/content/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces.md
index b964dbc0d551..b3952bd52f31 100644
--- a/content/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces.md
+++ b/content/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces.md
@@ -14,9 +14,13 @@ shortTitle: Dotfiles
 If your codespace fails to pick up configuration settings from dotfiles, you should work through the following debugging steps.
 
 1. Make sure your dotfiles repository is public. If you have secrets or sensitive data you want to use in your codespace, use [Codespace secrets](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces) instead of private dotfiles.
-2. Check `/workspaces/.codespaces/.persistedshare/dotfiles` to see if your dotfiles were cloned.
-    - If your dotfiles were cloned, try manually re-running your install script to verify that it is executable.
-    - If your dotfiles were not cloned, check `/workspaces/.codespaces/.persistedshare/EnvironmentLog.txt` to see if there was a problem cloning them.
-3. Check `/workspaces/.codespaces/.persistedshare/creation.log` for possible issues. For more information, see [Creation logs](/codespaces/troubleshooting/codespaces-logs#creation-logs).
+2. Enable dotfiles by selecting **Automatically install dotfiles** in [your personal Codespaces settings](https://github.com/settings/codespaces).
+
+   ![The 'Automatically install dotfiles' option](/assets/images/help/codespaces/automatically-install-dotfiles.png)
+
+3. Check `/workspaces/.codespaces/.persistedshare/dotfiles` to see if your dotfiles were cloned.
+   - If your dotfiles were cloned, try manually re-running your install script to verify that it is executable.
+   - If your dotfiles were not cloned, check `/workspaces/.codespaces/.persistedshare/EnvironmentLog.txt` to see if there was a problem cloning them.
+4. Check `/workspaces/.codespaces/.persistedshare/creation.log` for possible issues. For more information, see [Creation logs](/codespaces/troubleshooting/codespaces-logs#creation-logs).
 
 If the configuration from your dotfiles is correctly picked up, but part of the configuration is incompatible with codespaces, use the `$CODESPACES` environment variable to add conditional logic for codespace-specific configuration settings.