From aa72c0104e8f6b7769404c8e112b3c3f7dffaf99 Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Fri, 16 Oct 2026 18:29:32 +0200 Subject: [PATCH] Document page-level opt-out of social metadata From Quarto 1.11 (quarto-dev/quarto-cli#15091), `open-graph: false` or `twitter-card: false` in a page or a `_metadata.yml` omits that metadata when the website enables it. The page only described merging page and site metadata, so the opt-out was not discoverable. --- docs/websites/website-tools.qmd | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/websites/website-tools.qmd b/docs/websites/website-tools.qmd index 15ee1e3d00..b5c6394026 100644 --- a/docs/websites/website-tools.qmd +++ b/docs/websites/website-tools.qmd @@ -183,6 +183,24 @@ open-graph: Pages in that directory that use the site image also get these sizes. +### Disabling on a Page + +{{< prerelease-callout 1.11 >}} + +When `twitter-card` or `open-graph` is enabled under `website:`, a page can omit that metadata by setting the option to `false` in its front matter: + +```{.yaml filename="notes.qmd"} +--- +title: "Notes" +open-graph: false +twitter-card: false +--- +``` + +To omit it for every page in a directory, set the option to `false` in the directory's `_metadata.yml`. Each option is independent: a page with only `open-graph: false` still gets Twitter Card metadata. + +Before Quarto 1.11, `false` in a page had no effect when the website enabled the metadata. + ### Preview Images You can specify a preview image for your article in several different ways: