Create the Theme Manifest
Metadata for a theme is contained in the manifest.json file, which lives in the root directory of the theme zip that you upload to Weebly. Here you add functionality like responsiveness, color adjusting, and options like search and social icons.
In this topic:
Configure Theme Functionality
Create the manifest.json in the root directory. All manifests must contain the following:
manifest
The version of the Weebly Platform API your application was built to work with. The only currently supported value is "1".
version
The version of your theme. Provided as a string, following Semantic Versioning guidelines (Major.Minor.Patch: for example 1.5.13).
enableEditorJS
Set to true if you want your theme to use JavaScript.
manifest
The version of the Weebly Platform API your application was built to work with. The only currently supported value is "1".
version
The version of your theme. Provided as a string, following Semantic Versioning guidelines (Major.Minor.Patch: for example 1.5.13).
enableEditorJS
Set to true if you want your theme to use JavaScript.
Note: Please be aware of the current known issues when enabling JavaScript.
Note: Any URLs used in external scripts for your theme must use the HTTPS protocol.
responsive
Set to true if your theme is responsive, false if not. The default is false.
Set to true if your theme is responsive, false if not. The default is false.
Note: No quotes are needed for true/false values.
glyph-icons
Always set to true to use the Glyphicons social icons. (False uses the deprecated tmpSocialIconFont and should be avoided.)
is-dark
Set to true if your theme has a dark background.
If your theme has a dark background, certain portions of a site may not display correctly unless you specifically style those areas to account for it. By setting this property to true, this styling will be handled for you. For example, the Blog Comments area by default uses dark font on a light background. If your theme has a dark background, the font cannot be easily read. By setting this property to true, the font changes to a light color automatically.
Always set to true to use the Glyphicons social icons. (False uses the deprecated tmpSocialIconFont and should be avoided.)
is-dark
Set to true if your theme has a dark background.
If your theme has a dark background, certain portions of a site may not display correctly unless you specifically style those areas to account for it. By setting this property to true, this styling will be handled for you. For example, the Blog Comments area by default uses dark font on a light background. If your theme has a dark background, the font cannot be easily read. By setting this property to true, the font changes to a light color automatically.
Note: If you're creating color variations, set this within the variation and not for the theme.
color-support and color-presets
You can create color palettes that provide a default primary and accent color that the user can then override, allowing them to personalize and brand their site. See Create a Color Palette for more info on these manifest elements.
variations
You can create different color versions of your theme. For example, you might create a light version and a dark version.You configure the available versions in the manifest. See Add Color Palette Variations for more info about configuring these elements.
Custom options
You can create configurable options to your theme using our Options framework. For example, you might want to allow the user to turn off social icons or search, or display a phone number. The user sets options on the Theme Tab. You configure options in the manifest. See Create Theme Options for details.
You can create color palettes that provide a default primary and accent color that the user can then override, allowing them to personalize and brand their site. See Create a Color Palette for more info on these manifest elements.
variations
You can create different color versions of your theme. For example, you might create a light version and a dark version.You configure the available versions in the manifest. See Add Color Palette Variations for more info about configuring these elements.
Custom options
You can create configurable options to your theme using our Options framework. For example, you might want to allow the user to turn off social icons or search, or display a phone number. The user sets options on the Theme Tab. You configure options in the manifest. See Create Theme Options for details.
Sample Manifest
This sample manifest shows a theme without any options. To see an example using options, see Create Theme Options.
Theme Manifest