Join GitHub today
This article details how to install and setup the settings sync extension.
To open the extensions manager type Ctrl + Shift + X or click in the left panel.
In the search bar, typing Settings Sync. Hit the green Install button, then, the blue Reload button.
Using VSCode Marketplace
Go to our marketplace page here. Tap the big blue install button. In the popup, tap Open Visual Studio Code.
In the Visual Studio Code window that opens, tap Install in the popup at the top of the screen. Then, Reload the window again.
Using the Terminal or Command Line
Open the terminal. In Linux, this is usually Ctrl + Alt + T. Enter the command
code --install-extension Shan.code-settings-sync
Set Up Guide
Creating Github Personal Access Token
To upload and download any settings, it is required that you have this personal access token. This is required for both uploading and downloading.
Save the Token somewhere for future use. This is used to authenticate new Gists and downloading old Gists. Upon uploading, a Gist ID will be created, which is a different token.
Press Shift + Alt + U to start the upload sequence. Or, type >Sync: Update / Upload Settings into the command palette. This will open the GitHub create a new token page, where you can create the personal access token as detailed here.
In the popup window, enter the Github Personal Access token, then hit Enter. The Gist ID will be generated automatically and saved to settings.json. The Github Personal Access token will be saved to syncLocalSettings.json, located in the VSCode user folders.
You can validate that the Gist has been created successfully by navigating to:
Press Shift + Alt + D to start the download sequence, or type > Sync: Download Settings in the command palette.
IMPORTANT: If you have not uploaded your setup yet (see here, the first dialogue will be for the Github Personal Access Token, not the Gist ID. Enter the token, then proceed onwards.
Enter the Gist ID generated by another computer, which would be stored in that computer's settings.json.
This extension will create the syncLocalSettings.json inside User folder upon code start.
The appropriate folder locations are:
For more info on troubleshooting setup issues, see the Troubleshooting Wikipage