Title Page

The layout, background, and styling of the title page and the title, author, and revision information displayed on it is controlled from the theme using the keys in the title-page category.

The title page is only enabled by default for the book document type (e.g., :doctype: book). To enable the title page when using a different doctype, such as the default article doctype, you must define the title-page attribute in the document header.

For the list of all available title-page theme keys, see Title Page Category Keys.


The title page can be deactivated from the theme by assigning false to the title-page category key.

title-page: false

You can also deactivate the title page from the document header using the notitle attribute.

Background color

A background color can be applied to the title page with the background-color key. The key accepts the hex, RGB, and CMYK formats.

  background-color: #EAEAEA

To disable the background color for the title page, set the value to white (#FFFFFF). The color keyword transparent isn’t recognized in this context.

  background-color: #FFFFFF

Background image

You can apply a background image to the title page using the background-image key.

  background-image: image:title.png[]

For accepted values and attributes, see Background images.

Logo image

The target of the image macro assigned to the image key may be a data URI, absolute path, or a path relative to the value of the pdf-themesdir attribute. Like in the AsciiDoc syntax, wrapping the image value in the image macro allows you to specify other settings, including pdfwidth and align. For example:

    image: image:logo.png[pdfwidth=2.5in,align=center]

The align setting is used to align block images within the parent container. See Block Styles for accepted alignment keywords.