File

By default, not all pages are backed by a file, including top-level section pages, taxonomy pages, and term pages. By definition, you cannot retrieve file information when the file does not exist.

To back one of the pages above with a file, create an _index.md file in the corresponding directory. For example:

content/
└── books/
    ├── _index.md  <-- the top-slevel section page
    ├── book-1.md
    └── book-2.md

[!note] Code defensively by verifying file existence as shown in the examples below.

Methods

[!note] The path separators (slash or backslash) in Path, Dir, and Filename depend on the operating system.

BaseFileName

(string) The file name, excluding the extension.

{{ with .File }}
  {{ .BaseFileName }}
{{ end }}

ContentBaseName

(string) If the page is a branch or leaf bundle, the name of the containing directory, else the TranslationBaseName.

{{ with .File }}
  {{ .ContentBaseName }}
{{ end }}

Dir

(string) The file path, excluding the file name, relative to the content directory.

{{ with .File }}
  {{ .Dir }}
{{ end }}

Ext

(string) The file extension.

{{ with .File }}
  {{ .Ext }}
{{ end }}

Filename

(string) The absolute file path.

{{ with .File }}
  {{ .Filename }}
{{ end }}

IsContentAdapter

(bool) Reports whether the file is a content adapter.

{{ with .File }}
  {{ .IsContentAdapter }}
{{ end }}

LogicalName

(string) The file name.

{{ with .File }}
  {{ .LogicalName }}
{{ end }}

Path

(string) The file path, relative to the content directory.

{{ with .File }}
  {{ .Path }}
{{ end }}

Section

(string) The name of the top-level section in which the file resides.

{{ with .File }}
  {{ .Section }}
{{ end }}

TranslationBaseName

(string) The file name, excluding the extension and language identifier.

{{ with .File }}
  {{ .TranslationBaseName }}
{{ end }}

UniqueID

(string) The MD5 hash of .File.Path.

{{ with .File }}
  {{ .UniqueID }}
{{ end }}

Examples

Consider this content structure in a multilingual project:

content/
├── news/
│   ├── b/
│   │   ├── index.de.md   <-- leaf bundle
│   │   └── index.en.md   <-- leaf bundle
│   ├── a.de.md           <-- regular content
│   ├── a.en.md           <-- regular content
│   ├── _index.de.md      <-- branch bundle
│   └── _index.en.md      <-- branch bundle
├── _index.de.md
└── _index.en.md

With the English language site:

Defensive coding

Some of the pages on a site may not be backed by a file. For example:

• Top-level section pages
• Taxonomy pages
• Term pages

Without a backing file, Hugo will throw an error if you attempt to access a .File property. To code defensively, first check for file existence:

{{ with .File }}
  {{ .ContentBaseName }}
{{ end }}