Merge pull request #15474 from MicrosoftDocs/main

Auto Publish – main to live - 2026-06-02 22:00 UTC

Author: learn-build-service-prod[bot]

subscriptions/sign-in-github.md

@@ -3,22 +3,22 @@ title: Sign into subscription with your GitHub account
 author: joseb-rdc
 ms.author: amast
 ms.manager:  shve
-ms.date: 09/17/2024
+ms.date: 06/02/2026
 ms.topic: concept-article
-description: Sign into your Visual Studio subscriptions with your GitHub account for verification and find answers to frequently asked questions.
+description: Sign into your Visual Studio Subscriptions with your GitHub account for verification and find answers to frequently asked questions.
 ---
 
-# Signing in to Visual Studio subscription(s) with your GitHub account 
+# Signing in to Visual Studio Subscription(s) with your GitHub account 
 
-The steps to sign in to your Visual Studio subscription depend on the kind of account you're using. For example, you might be using a Microsoft Account (MSA) or an email address supplied by your employer or school. You can now also use your GitHub account to sign in to some subscriptions. 
+The steps to sign in to your Visual Studio Subscription depend on the kind of account you're using. For example, you might be using a Microsoft account (MSA) or an email address supplied by your employer or school. You can also use your GitHub account to sign in to some subscriptions. 
 
-This article provides the steps for signing in with your GitHub account.
+This article explains how GitHub sign-in works for Visual Studio Subscriptions.
 
 ## Signing in with your GitHub account
 
 GitHub identity support lets you use your existing GitHub account as a credential for a new or existing Microsoft account (MSA), linking your GitHub account with your MSA. 
 
-When you sign in with GitHub, Microsoft checks whether any email addresses associated with your GitHub account match an existing personal or enterprise Microsoft account. If the address matches your enterprise account, you're prompted to sign in to that account instead. If the address matches a personal account, we add your GitHub account as a sign-in method to that personal account.
+When you sign in with GitHub, Microsoft checks whether any email addresses associated with your GitHub account match an existing personal or enterprise Microsoft account. If the address matches your enterprise account, you're prompted to sign in to that account instead. The sign-in experience can vary depending on the Microsoft product or service you're accessing. In some cases, you might be redirected or signed in automatically instead of seeing a separate Microsoft account prompt. If the address matches a personal account, your GitHub account can be added as a sign-in method for that account.
 
 After you link your GitHub and Microsoft account credentials, you can use that single sign-in anywhere a personal Microsoft account can be used, like on Azure sites, Office apps, and Xbox. These accounts can also be used for Microsoft Entra guest sign-ins as a Microsoft account, assuming the email address matches the one on the invitation.
 
@@ -27,50 +27,50 @@ After you link your GitHub and Microsoft account credentials, you can use that s
 
 ### Frequently asked questions
 
-The following FAQs address questions you might encounter regarding the use of your GitHub account credentials to sign in to Visual Studio subscriptions.
+The following FAQs address questions you might encounter regarding the use of your GitHub account credentials to sign in to Visual Studio Subscriptions.
 
-#### Q: I forgot my GitHub password.  How can I access my account now?
+#### Q: I forgot my GitHub password. How can I access my account now?
 
-A:  You can recover your GitHub account by going to [Reset your password](https://github.com/password_reset). Or, you can recover your GitHub-linked Microsoft account by entering your GitHub account’s email address at [Recover your account](https://account.live.com/password/reset).
+A: You can recover your GitHub account by going to [Reset your password](https://github.com/password_reset). Or, you can recover your GitHub-linked Microsoft account by entering your GitHub account’s email address at [Recover your account](https://account.live.com/password/reset).
 
-#### Q: I deleted my GitHub account.  How can I access my Microsoft account (MSA) now?
+#### Q: I deleted my GitHub account. How can I access my Microsoft account (MSA) now?
 
 A: If you don’t have any other credentials on your MSA, like a password, Authenticator app, or security key, you can recover your Microsoft account by using the email address attached to it. To get started, go to [Recover your account](https://account.live.com/password/reset). You have to add a password to your account so we know how to sign you in later. 
 
-#### Q: There's no "Sign in with GitHub" option on the sign-in page.  How can I use my GitHub credentials to sign in?
+#### Q: There's no "Sign in with GitHub" option on the sign-in page. How can I use my GitHub credentials to sign in?
 
-A:  Type the GitHub account email address you chose when you created your GitHub-linked Microsoft account. We look you up and send you to GitHub for sign-in. Or, if there’s a **Sign-in options** link on the sign in page, use the **Sign in with GitHub** button shown after you select that link. 
+A: Type the GitHub account email address you chose when you created your GitHub-linked Microsoft account. We look you up and send you to GitHub for sign-in. Or, if there’s a **Sign-in options** link on the sign in page, use the **Sign in with GitHub** button shown after you select that link. 
 
-#### Q: I can't sign in to some of my apps and products with GitHub.  Why?
+#### Q: I can't sign in to some of my apps and products with GitHub. Why?
 
-A:  Not all Microsoft products can access GitHub.com from their sign-in page.  Xbox consoles are one example. Instead, when you type the email address from your linked GitHub account, we send a code to that address so we can verify it’s really you. You’re still signing in to the same account, just by a different sign-in method. 
+A: Not all Microsoft products can access GitHub.com from their sign-in page. Xbox consoles are one example. Instead, when you type the email address from your linked GitHub account, we send a code to that address so we can verify it’s really you. You’re still signing in to the same account, just by a different sign-in method. 
 
-#### Q:  I added a password to the Microsoft account I linked to my GitHub account.  Does that cause a problem?
+#### Q: I added a password to the Microsoft account I linked to my GitHub account. Does that cause a problem?
 
 A:  Not at all. Linking doesn’t change your GitHub password; you just have another way to sign in to your Microsoft account. Whenever you sign in using your email address, we offer you the choice of signing in with your Microsoft account password or going to GitHub to sign in. We strongly recommend that, if you need to add a password, you make sure it’s different from the password for your GitHub account.
 
-#### Q: I want to add the Authenticator app to the account I created using GitHub.  Can I do that?
+#### Q: I want to add the Authenticator app to the account I created using GitHub. Can I do that?
 
-A:  Absolutely.  Just download the app and sign in using your email address. When you sign in with your email address, you're prompted to choose either the [Authenticator app](https://www.microsoft.com/p/microsoft-authenticator/9nblgggzmcj6) or GitHub as your credential.
+A: Absolutely.  Just download the app and sign in using your email address. When you sign in with your email address, you're prompted to choose either the [Authenticator app](https://www.microsoft.com/p/microsoft-authenticator/9nblgggzmcj6) or GitHub as your credential.
 
-#### Q: I enabled two-factor authentication on both my GitHub and Microsoft accounts (MSA), but when I sign in to my MSA, I'm still asked to authenticate twice.  Why?
+#### Q: I enabled two-factor authentication on both my GitHub and Microsoft accounts (MSA), but when I sign in to my MSA, I'm still asked to authenticate twice. Why?
 
 A: Because of security restrictions, Microsoft counts signing in with GitHub as a single-factor verification, even if you have two-step verification enabled there. Therefore, you have to authenticate again for your Microsoft account. 
 
-#### Q:  How can I tell if my Microsoft account and GitHub accounts are linked?
+#### Q: How can I tell if my Microsoft account and GitHub accounts are linked?
 
-A:  Whenever you sign in using your account alias (email address, phone number, Skype name), we show you all the sign-in methods for your account. If you don’t see GitHub there, you haven’t set it up yet.
+A: Whenever you sign in using your account alias (email address, phone number, Skype name), we show you all the sign-in methods for your account. If you don’t see GitHub there, you haven’t set it up yet.
 
-#### Q:  How can I unlink my Microsoft and GitHub accounts? 
+#### Q: How can I unlink my Microsoft and GitHub accounts? 
 
-A:  Go to the [Security tab](https://account.microsoft.com/security) of account.microsoft.com and select **Advanced security options** to unlink your GitHub account. Unlinking your GitHub account removes it as a sign-in method and removes access to any GitHub repositories in Visual Studio. Other Microsoft products might request access your GitHub account separately, so removing the access here doesn't remove access in all products. Go to the [application permissions](https://github.com/settings/applications) page of your GitHub profile to revoke consent from the apps listed there.
+A: Go to the [Security tab](https://account.microsoft.com/security) of account.microsoft.com and select **Advanced security options** to unlink your GitHub account. Unlinking your GitHub account removes it as a sign-in method and removes access to any GitHub repositories in Visual Studio. Other Microsoft products might request access your GitHub account separately, so removing the access here doesn't remove access in all products. Go to the [application permissions](https://github.com/settings/applications) page of your GitHub profile to revoke consent from the apps listed there.
 
-#### Q:  I try to use my GitHub account to sign in, but I'm prompted that I already have a Microsoft identity that I should use instead.  What's happening?
+#### Q: I try to use my GitHub account to sign in, but I'm prompted that I already have a Microsoft identity that I should use instead. What's happening?
 
-A:  If you have a Microsoft Entra ID email address on your GitHub account, you already have a Microsoft identity that can access Azure and run CI pipelines using your GitHub code. Using that account ensures that your Azure resources and build pipelines remain within your organizational boundaries. However, if you’re doing personal work, we recommend putting a personal email address on your GitHub account so that you always have access to it. Once you do add the address, try signing in again and choose **Use a different email address** when you're prompted to sign in to your work or school account. This choice lets you create a new Microsoft account using that personal email address.
+A: If you have a Microsoft Entra ID email address on your GitHub account, you already have a Microsoft identity that can access Azure and run CI pipelines using your GitHub code. Using that account ensures that your Azure resources and build pipelines remain within your organizational boundaries. However, if you’re doing personal work, we recommend putting a personal email address on your GitHub account so that you always have access to it. Once you do add the address, try signing in again and choose **Use a different email address** when you're prompted to sign in to your work or school account. This choice lets you create a new Microsoft account using that personal email address.
 
 ## Resources
-For assistance with sales, subscriptions, accounts, and billing for Visual Studio Subscriptions, see Visual Studio [Subscriptions support](https://aka.ms/vssubscriberhelp).
+For assistance with sales, subscriptions, accounts, and billing for Visual Studio Subscriptions, see [Visual Studio Subscriptions support](https://aka.ms/vssubscriberhelp).
 
 ## See also