• Documentation
• Reference
• Readable filters

Readable filters

Podcaster provides three filters that you can use to format dates, durations and file sizes. These filters help you present information about your podcast episodes in a readable format.

readableDate

The readableDate filter formats a date object as a localised full date, including the weekday.

The default format is Thursday 8 January 2026. However, you can specify a locale for the filter when you add the plugin to your Eleventy config file.

eleventy.config.js

import Podcaster from 'eleventy-plugin-podcaster'

export default function (eleventyConfig) {
  …
  eleventyConfig.addPlugin(Podcaster, {
    readableDateLocale: 'en-GB' // Thursday, 8 January 2026
  })
  …
}

In English, the two most common locale strings are 'en-GB' and 'en-US'.

readableDuration

The readableDuration filter formats a number of seconds in one of two formats — a default format, and a long format.

The default format is useful for specifying the durations of podcast episodes, and is used for that purpose in the podcast feed. It’s mm:ss for durations of less than an hour, and h:mm:ss for longer durations.

The long format includes days and uses the full English names for units of time. It’s useful for specifying the total duration of all of a podcast’s episodes.

To specify the long format, pass "long" to the filter. In Liquid, that will look like this: {{ 3660 | readableDuration: "long" }}. In Nunjucks, it will look like this: {{ 3660 | readableDuration("long") }}.

readableSize

The readableSize filter formats a number of bytes as a human-readable size in kilobytes, megabytes or gigabytes. By default, this format includes a single number to one decimal place, followed by a standard SI unit abbreviation.

If you want to specify a different precision for the number, specify the number of decimal places you want. In Liquid, that will look like this: {{ 1024 | readableSize: 2 }}. In Nunjucks, it will look like this: {{ 1024 | readableSize(2) }}.