Skip to content

Frontmatter Reference ​

Every content file starts with a frontmatter block — a section of metadata between --- lines at the top of the file. This page documents every field for each content type.

Content Pages ​

Used for general pages like the about page (over-ons/index.md) and the investigations overview (onderzoek/index.md).

yaml
---
title: Over Ons
description: >-
  Sluit je aan bij Ongehoord en help dierenleed in de
  Nederlandse dierindustrie te stoppen.
image:
  src: /images/pages/over-ons/over-ons.jpg
  alt: Over Ons.
sitemap:
  priority: 0.7
  changefreq: monthly
robots: index, follow
schemaOrg:
  - "@type": "AboutPage"
    name: "Over Ongehoord"
    description: "Informatie over Ongehoord"
modifiedAt: '2026-02-18'
---

Fields ​

FieldTypeRequiredDescription
titlestringYesPage title (shown in browser tab and headings)
descriptionstringYesPage description (used for SEO meta tags, 150-160 chars ideal)
image.srcstring (URL)YesPath to the header image, starting with /images/
image.altstringYesAlt text for the image (for accessibility)
sitemap.prioritynumberNoSitemap priority from 0.0 to 1.0 (default: 0.5)
sitemap.changefreqstringNoHow often the page changes: always, hourly, daily, weekly, monthly, yearly, never
robotsstringNoRobots directive, e.g. index, follow or noindex, nofollow
schemaOrgarrayNoStructured data for search engines (advanced, ask a developer)
modifiedAtstring (date)NoLast modification date in YYYY-MM-DD format

Investigations ​

The main content type. Used for investigation articles at onderzoek/*/index.md.

yaml
---
title: Het leven van een varken
description: >-
  Het onderzoeksteam van Ongehoord bezocht maarliefst
  26 varkensfokkers. Het resultaat was een enorme
  verzameling van gewonde, zieke en dode dieren.
animals:
  - pig
video: https://vimeo.com/522281301
image:
  src: /images/investigations/het-leven-van-een-varken/hero.jpg
  alt: Het leven van een varken
date: 2011-06-19
published: true
modifiedAt: '2025-10-20'
robots: index, follow
sitemap:
  changefreq: monthly
  priority: 0.8
---

Fields ​

FieldTypeRequiredDescription
titlestringYesInvestigation title
descriptionstringYesBrief summary (150-160 chars for SEO)
animalsstring[]YesArray of animal keys (see valid values below)
videostring (URL)YesVimeo URL for the investigation video
image.srcstring (URL)YesPath to the cover image
image.altstringYesAlt text for the cover image
datedateYesPublication date in YYYY-MM-DD format
publishedbooleanYestrue to show on the site, false for drafts
modifiedAtdateNoLast modification date
robotsstringNoRobots directive
sitemapobjectNoSitemap configuration

WARNING

Setting published: false hides the investigation from the overview page and search engines. Use this for draft content that isn't ready yet.

Investigation Chapters ​

Used for chapter pages at onderzoek/*/hoofdstukken/*.md.

yaml
---
title: Natuurlijk leven
description: Het leven van een varken - Natuurlijk leven
image:
  src: /images/investigations/het-leven-van-een-varken/natuurlijk-leven.jpg
  alt: Natuurlijk leven
modifiedAt: '2025-10-20'
---

Fields ​

FieldTypeRequiredDescription
titlestringYesChapter title
descriptionstringNoChapter description
image.srcstring (URL)YesChapter header image
image.altstringYesAlt text
modifiedAtdateNoLast modification date

TIP

The chapter number prefix in the filename (e.g., 1.natuurlijk-leven.md) determines the display order. You don't need an explicit order field — just name the file correctly.

Locations ​

Used for location pages at onderzoek/*/locaties/*.md. Each location represents a farm, slaughterhouse, or other site filmed during an investigation.

yaml
---
position:
  lat: 51.91561380008353
  lng: 6.493277121053491
address:
  street: Gendringseweg 37
  postalCode: 7122 LT
  city: Aalten
  country: nl
video: https://youtu.be/oC4ODPcinRs
animals:
  - pig
welfareBrandKey: beter-leven-1
owner: Paul Jansen
organization: BL1
stableSystem: ''
companyName: ''
title: Varkensmishandeling bij Paul Jansen in Aalten
modifiedAt: '2025-12-11'
---

Fields ​

FieldTypeRequiredDescription
titlestringYesLocation title (descriptive name)
position.latnumberYesLatitude (decimal degrees)
position.lngnumberYesLongitude (decimal degrees)
address.streetstringYesStreet name and number
address.postalCodestringYesPostal code
address.citystringYesCity name
address.countryenumYesnl (Netherlands) or be (Belgium)
videostring (URL)YesYouTube or Vimeo URL for this location's footage
animalsstring[]YesArray of animal keys
welfareBrandKeyenum | nullYesWelfare brand key or null if none (see valid values)
ownerstringYesName of the farm owner
organizationstring | nullYesOrganization name, or null
stableSystemstring | nullYesType of stable system, or null
companyNamestring | nullYesCompany name, or null
visibleboolean | nullNoWhether the location is visible on the map
modifiedAtdateNoLast modification date

Getting coordinates

The easiest way to find latitude and longitude:

  1. Go to Google Maps
  2. Right-click on the location
  3. Click the coordinates that appear — they're copied to your clipboard
  4. The first number is latitude, the second is longitude

About Page Sections ​

Used for sections on the about page at over-ons/01.hero.md, 02.onze-positie.md, etc.

yaml
---
title: Over Ongehoord
section: hero
background: dark
---

Fields ​

FieldTypeRequiredDescription
titlestringYesSection title
sectionstringNoSection identifier (used by the page layout)
backgroundstringNoBackground style: dark, muted, or omit for default

Annotation Sources ​

Used for scientific references and citations at onderzoek/*/bronnen/*.md. These files are very simple — they contain only the reference text, no frontmatter:

markdown
Marino, L. & Colvin, C.M. (2015) Thinking pigs: a comparative
review of cognition, emotion, and personality in Sus domesticus.
International Journal of Comparitive Psychology, 28

The filename is the source number: 1.md, 2.md, 3.md, etc.

See Investigations — Annotations for how to reference these in chapter text.

Enum Reference ​

Animal Keys ​

Use these exact values in the animals array:

KeyDutchEnglish
chicken-eggKip (eieren)Chicken (eggs)
chicken-meatKip (vlees)Chicken (meat)
cowRundCow
deerHertDeer
minkNertsMink
pigVarkenPig
rabbitKonijnRabbit
turkeyKalkoenTurkey

Welfare Brand Keys ​

Use these exact values for welfareBrandKey:

KeyLabel
beter-leven-1Beter Leven 1 ster
beter-leven-2Beter Leven 2 sterren
beter-leven-3Beter Leven 3 sterren
caring-farmersCaring Farmers
ekoEKO
parkkonijnParkkonijn
nullNo welfare brand

Country Codes ​

CodeCountry
nlNetherlands
beBelgium

SEO Fields ​

These fields improve how the page appears in search engines and social media:

yaml
---
title: Page Title          # Also used as og:title
description: Description   # Also used as og:description and meta description
image:
  src: /images/investigations/<slug>/hero.jpg   # Also used as og:image
robots: index, follow      # Controls search engine indexing
sitemap:
  priority: 0.8            # 0.0 to 1.0 — how important is this page?
  changefreq: monthly      # How often does it change?
schemaOrg:                 # Structured data for rich search results
  - "@type": "Article"
---

TIP

For most content, you only need title, description, and image. The SEO fields (robots, sitemap, schemaOrg) are optional and already have sensible defaults.