Skip to content
Hugo theme component to add social metadata to your Hugo site with minimal configuration
Branch: master
Clone or download
msfjarvis Allow override card type
Signed-off-by: Harsh Shandilya <>
Latest commit 7aa3c15 Feb 10, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
layouts/partials Allow override card type Feb 10, 2020
LICENSE Initial commit Feb 2, 2020 README: Document including hugo-social-metadata in themes Feb 2, 2020



This is a Hugo theme component that automatically generates metadata complying to The Open Graph Protocol as well as Twitter Cards. This is NOT a standalone theme and must not be treated as such.


  1. Add the hugo-social-metadata repository as a submodule to be able to get upstream changes later git submodule add themes/hugo-social-metadata

  2. Start off by configuring a few things in your config.toml (or equivalent file depending on whether you use YAML or JSON). These will be picked up by the theme component and used to provide metadata for the site.

  description = "A description for your awesome website goes here"
  keywords = "some, keywords, that, describe, your, content"
  twitterUsername = "@your_twitter_username"
  socialImage = "path/to/the/twitter/card/image"
  1. Include the hugo-social-metadata theme as the leftmost element of the theme list variable in your config file. For config.toml, it will look something like this:
theme = ["hugo-social-metadata", "hyde"]
  1. Include the social_metadata.html partial in your head.html like so: {{ partial "social_metadata.html" . }}.

Additional customizations

You can customize some of the generated metadata on a per-page basis. Setting description, socialImage or tags in the frontmatter will override the defaults loaded from the main config file.

description = "A nice description for this blogpost"
socialImage = "path/to/an/image/that/describes/this/post/best"
tags = ["this", "blog", "rocks!"]


Check out the LICENSE file in the root of this repository.

You can’t perform that action at this time.