Media in templates means getting the URL of an image or file so you can use it in <img src="…"> or <a href="…">Download</a>.

Single image from the Media Library (by name)

If you uploaded a file (e.g. logo.svg) to the Media Library and want to use it anywhere:

<img src="{ media 'logo.svg' }" alt="Company logo">

Use the exact filename. The template outputs the full URL to that file.

Single image from the current entry (by field name)

If the entry has a Media field, e.g. “Featured image” with key featured_image:

<img src="{ media featured_image }" alt="{ title }">

Inside a loop, this is the current entry’s featured image. On a single-entry page, it’s that entry’s image.

Always provide an alt text

Use alt="{ title }" or a short description. If the image might be empty, use a conditional so you don’t output a broken image:

{if entry has featured_image}
  <img src="{ media featured_image }" alt="{ title }">
{else}
  <img src="/images/placeholder.jpg" alt="">
{endif}

See Conditionals.

Link to a file (e.g. PDF)

If the entry has a File or Media field pointing to a document:

<a href="{ media document }" download>Download PDF</a>

Or: <a href="{ document }"> — exact syntax depends on the field type; see your templating docs.

Multiple images (gallery)

For a Gallery field with several images, you loop and output one <img> per item:

{for each image in gallery_field}
  <img src="{ image }" alt="">
{endfor}

Variable names may vary (e.g. image.url or just the URL in { image }). See Loops and lists and your engine’s docs.

Thumbnails or resized images

Some setups let you ask for a resized version, e.g.:

• { media featured_image width=400 height=300 }
• or { media 'hero.jpg' width=1200 crop="center" }

That would give you a URL to a version that fits those dimensions (or is cropped). If your Birkly version doesn’t support this, use the plain URL and size the image with CSS, or use a separate image service.