Configure content types

Hugo supports six content formats:

These can be used as either page content or page resources. When used as page resources, their resource type is page.

Consider this example of a page bundle:

content/
└── example/
    ├── index.md  <-- content
    ├── a.adoc    <-- resource (resource type: page)
    ├── b.html    <-- resource (resource type: page)
    ├── c.md      <-- resource (resource type: page)
    ├── d.org     <-- resource (resource type: page)
    ├── e.pdc     <-- resource (resource type: page)
    ├── f.rst     <-- resource (resource type: page)
    ├── g.jpg     <-- resource (resource type: image)
    └── h.png     <-- resource (resource type: image)

The index.md file is the page’s content, while the other files are page resources. Files a through f are of resource type page, while g and h are of resource type image.

When you build a site, Hugo does not publish page resources having a resource type of page. For example, this is the result of building the site above:

public/
├── example/
│   ├── g.jpg
│   ├── h.png
│   └── index.html
└── index.html

The default behavior is appropriate in most cases. Given that page resources containing markup are typically intended for inclusion in the main content, publishing them independently is generally undesirable.

The default behavior is determined by the contentTypes configuration:

contentTypes:
  text/asciidoc: {}
  text/html: {}
  text/markdown: {}
  text/org: {}
  text/pandoc: {}
  text/rst: {}

[contentTypes]
  [contentTypes.'text/asciidoc']
  [contentTypes.'text/html']
  [contentTypes.'text/markdown']
  [contentTypes.'text/org']
  [contentTypes.'text/pandoc']
  [contentTypes.'text/rst']

{
   "contentTypes": {
      "text/asciidoc": {},
      "text/html": {},
      "text/markdown": {},
      "text/org": {},
      "text/pandoc": {},
      "text/rst": {}
   }
}

In this default configuration, page resources with those media types will have a resource type of page, and will not be automatically published. To change the resource type assignment from page to text for a given media type, remove the corresponding entry from the list.

For example, to set the resource type of text/html files to text, thereby enabling automatic publication, remove the text/html entry:

contentTypes:
  text/asciidoc: {}
  text/markdown: {}
  text/org: {}
  text/pandoc: {}
  text/rst: {}

[contentTypes]
  [contentTypes.'text/asciidoc']
  [contentTypes.'text/markdown']
  [contentTypes.'text/org']
  [contentTypes.'text/pandoc']
  [contentTypes.'text/rst']

{
   "contentTypes": {
      "text/asciidoc": {},
      "text/markdown": {},
      "text/org": {},
      "text/pandoc": {},
      "text/rst": {}
   }
}