Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Project Specific Syntax Settings

This package allows syntax settings to be specified per project.

In your .sublime-project file, you just need to add a syntax_override section, like so.

        // Your project folders

    "syntax_override": {
        "\\.html$": ["Handlebars", "grammars", "Handlebars"],
        "\\.js$": ["Babel", "JavaScript (Babel)"]

The syntax_override section can contain as many key/value pairs as you like.

The easiest way to construct these key/value pairs is to follow these steps:

  1. Open an existing file in your project.
  2. Set the syntax you would like to use for that file with the View > Syntax > ... menus or the command palette.
  3. Right click in the file editor area, and select the Project Specific Syntax > Copy syntax setting to clipboard menu item. This menu item is also available via the command palette.
  4. Open your project file for editing via the Project > Edit Project menu or the command palette.
  5. Paste the new key/value pair into the syntax_override section of your project file. Be sure to add any necessary commas to separate multiple key/value pairs so your project file is still valid JSON.

If you need more control, you can construct your own key/value pairs. The key should be a regular expression that will be matched against the name of the file. Note that the . in .html in the example above has to be escaped to \. since it will otherwise match any character. And since this is a JSON string, we need to escape the slash, so we end up with \\..

The value in the key/value pair should be an array containing two or more strings. All but the last string in this array are the names of the package directories containing the syntax file and the last is the name of the syntax. Root around in Sublime Text's directory structure to find files that end with .sublime-syntax or .tmLanguage. The names of these files (minus the .sublime-syntax/.tmLanguage extension) are what you would use for the last string. Typically, you will only have two strings, a directory name and the syntax file name (minus .sublime-syntax/.tmLanguage file extension), but this is dependent on the package's directory structure.

More info about projects and the project file format can be found at the Sublime Text website and at the Sublime Text Unofficial Documentation website.


Allows syntax settings to be specified per project in Sublime Text







No packages published