People with write permissions for a repository can add a theme to a site using Jekyll.

Adding a theme

1. Navigate to _config.yml.

2. Add a new line to the file for the theme name.

   • To use a supported theme, type theme: THEME-NAME, replacing THEME-NAME with the name of the theme as shown in the _config.yml of the theme's repository (most themes follow a jekyll-theme-NAME naming convention). For a list of supported themes, see "Supported themes" on the site. For example, to select the Minimal theme, type theme: jekyll-theme-minimal.
   • To use any other Jekyll theme hosted on , type remote_theme: THEME-NAME, replacing THEME-NAME with the name of the theme as shown in the README of the theme's repository.

Customizing your theme's CSS

1. Create a new file called /assets/css/style.scss.

2. Add the following content to the top of the file:

3. Add any custom CSS or Sass (including imports) you'd like immediately after the @import line.

Customizing your theme's HTML layout

1. On , navigate to your theme's source repository. For example, the source repository for Minimal is https://github.com/pages-themes/minimal.

2. In the _layouts folder, navigate to your theme's default.html file.

3. Copy the contents of the file.

4. Create a file called _layouts/default.html.

5. Paste the default layout content you copied earlier.

6. Customize the layout as you'd like.

Further reading

• "AUTOTITLE"