Setup Guide

Jason edited this page Dec 11, 2018 · 3 revisions

This article details how to install and setup the settings sync extension.


Using VSCode

To open the extensions manager type Ctrl + Shift + X or click Icon 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.

Go to Settings / Developer settings / Personal access tokens / Generate New Token This page will be automatically opened when you choose Upload or Download Settings for the first time.


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.

Uploading Settings

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:{your_userName}/{gist_id}

Downloading Settings

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.


User Folders

This extension will create the syncLocalSettings.json inside User folder upon code start.

The appropriate folder locations are:

  • Windows: %APPDATA%\Code\User\syncLocalSettings.json
  • Mac: $HOME/Library/Application Support/Code/User/syncLocalSettings.json
  • Linux: ~/.config/Code/User/settings.json


For more info on troubleshooting setup issues, see the Troubleshooting Wikipage

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.