HUGO
News Docs Themes Community GitHub

ExpiryDate

Returns the expiry date of the given page.

Syntax

PAGE.ExpiryDate

Returns

time.Time

By default, Hugo excludes expired pages when building your site. To include expired pages, use the --buildExpired command line flag.

Set the expiry date in front matter:

---
expiryDate: 2024-10-19T00:32:13-07:00
title: Article 1
---
+++
expiryDate = 2024-10-19T00:32:13-07:00
title = 'Article 1'
+++
{
   "expiryDate": "2024-10-19T00:32:13-07:00",
   "title": "Article 1"
}

The expiry date is a time.Time value. Format and localize the value with the time.Format function, or use it with any of the time methods.

{{ .ExpiryDate | time.Format ":date_medium" }} → Oct 19, 2024

In the example above we explicitly set the expiry date in front matter. With Hugo’s default configuration, the ExpiryDate method returns the front matter value. This behavior is configurable, allowing you to set fallback values if the expiry date is not defined in front matter. See  details.