<spanclass=mb-[2px]><ahref=https://github.com/jpanther/congo/tree/dev/exampleSite/content/docs/front-matter/index.mdclass="text-lg hover:text-primary-500"rel="noopener noreferrer"target=_blanktitle="Edit content"><spanclass="relative inline-block align-text-bottom px-1 icon"><svgxmlns="http://www.w3.org/2000/svg"viewBox="0 0 512 512"><pathfill="currentcolor"d="M490.3 40.4c21.9 21.87 21.9 57.33.0 79.2l-30 30.1-98-97.98 30.1-30.06C414.3-.2135 449.7-.2135 471.6 21.66L490.3 40.4zM172.4 241.7 339.7 74.34l98 97.96L270.3 339.6C264.2 345.8 256.7 350.4 248.4 353.2l-88.8 29.6C150.1 385.6 141.5 383.4 135 376.1 128.6 370.5 126.4 361 129.2 352.4l29.6-88.8C161.6 255.3 166.2 247.8 172.4 241.7v0zM192 63.1c17.7.0 32 15.23 32 32 0 18.6-14.3 32-32 32H96c-17.67.0-32 15.2-32 32V416c0 17.7 14.33 32 32 32H352c17.7.0 32-14.3 32-32V319.1c0-16.8 14.3-32 32-32s32 15.2 32 32V416c0 53-43 96-96 96H96c-53.02.0-96-43-96-96V159.1c0-53 42.98-96 96-96h96z"/></svg></span></a></span></div></div></header><sectionclass="flex flex-col max-w-full mt-0 prose dark:prose-invert lg:flex-row"><divclass="min-w-0 min-h-0 max-w-prose grow"><p>In addition to the <ahref=https://gohugo.io/content-management/front-matter/#front-matter-variablestarget=_blankrel=noreferrer>default Hugo front matter parameters</a>, Congo adds a number of additional options to customise the presentation of individual articles. All the available theme front matter parameters are listed below.</p><p>Front matter parameter default values are inherited from the theme’s
<ahref=https://jpanther.github.io/congo/docs/configuration/>base configuration</a>, so you only need to specify these parameters in your front matter when you want to override the default.</p><table><thead><tr><th>Name</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>title</code></td><td><em>Not set</em></td><td>The name of the article.</td></tr><tr><td><code>description</code></td><td><em>Not set</em></td><td>The text description for the article. It is used in the HTML metadata.</td></tr><tr><td><code>feature</code></td><td><code>"*feature*"</code></td><td>The text pattern to match the feature image filename for this article.</td></tr><tr><td><code>featureAlt</code></td><td><code>""</code></td><td>The alternative text description for the feature image.</td></tr><tr><td><code>cover</code></td><td><code>"*cover*"</code></td><td>The text pattern to match the cover image filename for this article.</td></tr><tr><td><code>coverAlt</code></td><td><code>featureAlt</code></td><td>The alternative text description for the cover image.</td></tr><tr><td><code>coverCaption</code></td><td><em>Not set</em></td><td>The figure caption text to be displayed beneath the cover image.</td></tr><tr><td><code>thumbnail</code></td><td><code>"*thumb*"</code>_</td><td>The text pattern to match the thumbnail image filename for this article.</td></tr><tr><td><code>thumbnailAlt</code></td><td><code>featureAlt</code></td><td>The alternative text description for the thumbnail image.</td></tr><tr><td><code>externalUrl</code></td><td><em>Not set</em></td><td>If this article is published on a third-party website, the URL to this article. Providing a URL will prevent a content page being generated and any references to this article will link directly to the third-party website.</td></tr><tr><td><code>editURL</code></td><td><code>article.editURL</code></td><td>When <code>showEdit</code> is active, the URL for the edit link.</td></tr><tr><td><code>editAppendPath</code></td><td><code>article.editAppendPath</code></td><td>When <code>showEdit</code> is active, whether or not the path to the current article should be appended to the URL set at <code>editURL</code>.</td></tr><tr><td><code>groupByYear</code></td><td><code>list.groupByYear</code></td><td>Whether or not articles are grouped by year on list pages.</td></tr><tr><td><code>keywords</code></td><td><em>Not set</em></td><td>Any keywords that should be included in the article metadata.</td></tr><tr><td><code>menu</code></td><td><em>Not set</em></td><td>When a value is provided, a link to this article will appear in the named menus. Valid values are <code>main</code> or <code>footer</code>.</td></tr><tr><td><code>robots</code></td><td><em>Not set</em></td><td>String that indicates how robots should handle this article. If set, it will be output in the page head. Refer to <ahref=https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directivestarget=_blankrel=noreferrer>Google’s docs</a> for valid values.</td></tr><tr><td><code>sharingLinks</code></td><td><code>article.sharingLinks</code></td><td>Which sharing links to display at the end of this article. When not provided, or set to <code>false</code> no links will be displayed.</td></tr><tr><td><code>showAuthor</code></td><td><code>article.showAuthor</code></td><td>Whether or not the author box is displayed in the article footer.</td></tr><tr><td><code>showBreadcrumbs</code></td><td><code>article.showBreadcrumbs</code> or <code>list.showBreadcrumbs</code></td><td>Whether the breadcrumbs are displayed in the article or list header.</td></tr><tr><td><code>showDate</code></td><td><code>article.showDate</code></td><td>Whether or not the article date is displayed. The date is set using the <code>date</code> parameter.</td></tr><tr><td><code>showDateUpdated</code></td><td><code>article.showDateUpdated</code></td><td>Whether or not the date the article was updated is displayed. The date is set using the <code>lastmod</code> parameter.</td></tr><tr><td><code>showEdit</code></td><td><code>article.showEdit</code><
<ahref=https://jpanther.github.io/congo/docs/partials/#comments>comments partial</a> is included after the article footer.</td></tr><tr><td><code>showSummary</code></td><td><code>list.showSummary</code></td><td>Whether or not the article summary should be displayed on list pages.</td></tr><tr><td><code>summary</code></td><td>Auto generated using <code>summaryLength</code> (see
<ahref=https://jpanther.github.io/congo/docs/configuration/#site-configuration>site configuration</a>)</td><td>When <code>showSummary</code> is enabled, this is the Markdown string to be used as the summary for this article.</td></tr><tr><td><code>xml</code></td><td><code>true</code> unless excluded by <code>sitemap.excludedKinds</code></td><td>Whether or not this article is included in the generated <code>/sitemap.xml</code> file.</td></tr></tbody></table></div></section><footerclass="pt-8 max-w-prose print:hidden"><divclass=pt-8><hrclass="border-dotted border-neutral-300 dark:border-neutral-600"><divclass="flex justify-between pt-3"><span><aclass="group flex"href=/congo/docs/homepage-layout/><spanclass="me-2 text-neutral-700 transition-transform group-hover:-translate-x-[2px] group-hover:text-primary-600 dark:text-neutral dark:group-hover:text-primary-400"><spanclass="ltr:inline rtl:hidden">←</span><spanclass="ltr:hidden rtl:inline">→</span></span>
