Header values can include request path tokens that are replaced at request time by the CloudFront viewer-response function.

Available tokens#

Example: local development path#

This site uses a request path token to emit a header pointing to the local development URL for each page:

# In _index.md frontmatter (applied to root "/")
HedgerulesHeaders:
  X-Hedgerules-Local-Development-Path: "http://localhost:1313{/path}"

A request to /docs/headers/ produces the response header:

X-Hedgerules-Local-Development-Path: http://localhost:1313/docs/headers/

Without request path tokens, you would need to set this header individually in every page’s frontmatter.

Example: Onion-Location#

The Onion-Location header tells Tor Browser that your site is available as an onion service. The header value must include the full .onion URL for the current page.

With request path tokens, you can set this once on root / and have it work for every page:

[params.HedgerulesPathHeaders]
  [params.HedgerulesPathHeaders."/"]
    Onion-Location = "http://example2255goo6ofqontxj.onion{/path}"

A request to /docs/headers/ produces the response header:

Onion-Location: http://example2255goo6ofqontxj.onion/docs/headers/