You can apply a range of settings to how your books build in _data/settings.yml.

Electric Book Manager

These settings are not yet used. In future, we expect to use this setting to allow or disallow Electric Book Manager servers to access your book project.

electric-book-manager: enable
electric-book-manager-key: ""


See Variants.


These settings control the content of your masthead in web and app outputs. You can have different settings for web and app output. Your masthead can display:

For example:

    content: page-title
    content: breadcrumbs

Note that breadcrumbs slows your site build down significantly. So we recommend not using them for very big sites.


Pagination is the links to the previous and next HTML pages in your books. By default these links appear at the bottom of each page.

You define pagination for web and app output separately, so that they can differ if you need them to.

See Pagination for details.


You can turn on open annotation with by setting the annotator settings for the development and/or live versions of your website to true (i.e. annotation on) or false (i.e. annotation off).

By default, the template turns annotation for development, and off for live. This is because annotation can be useful during development for discussing changes within a team.

Epub settings

You’ll need to adjust the epub settings if you want to embed fonts or hide the epub’s nav element. See Epub output for details.

App settings

Among other things, this is where you enable a Google Play expansion file, if you need one for a large app. This is a rare need, so by default this is off (false).

google-play-expansion-file-enabled: false
google-play-public-api-key: ""

External media

If a large number of images makes your project too big, you can store your images in a separate location. See External media for details.