<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>Opengraph on Haseeb Majid</title>
    <link>https://haseebmajid.dev/tags/opengraph/</link>
    <description>Haseeb Majid&#39;s blog</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>en</language>
    <lastBuildDate>Tue, 17 Nov 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://haseebmajid.dev/tags/opengraph/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>How I Generate Open Graph Images With Hugo</title>
      <link>https://haseebmajid.dev/posts/2026-11-17-how-i-generate-open-graph-images-with-hugo/</link>
      <pubDate>Tue, 17 Nov 2026 00:00:00 +0000</pubDate>
      <author>Haseeb Majid</author>
      <guid>https://haseebmajid.dev/posts/2026-11-17-how-i-generate-open-graph-images-with-hugo/</guid>
      <description>&lt;p&gt;I&amp;rsquo;ve been using &lt;a href=&#34;https://github.com/LordMathis/tcardgen&#34;&gt;tcardgen&lt;/a&gt; to generate the cover images for my posts. It
works, but it&amp;rsquo;s another command to remember to run whenever I write a new post, and the generated images end up
committed to the repo. Also it was some code I needed to &amp;ldquo;maintain&amp;rdquo;, I&amp;rsquo;m always a fan of deleting code.&lt;/p&gt;
&lt;p&gt;Recently, as part of redesigning my blog, I moved to generating the OG images with Hugo at build time instead.
So lets see how I did that:&lt;/p&gt;</description><content:encoded><![CDATA[<p>I&rsquo;ve been using <a href="https://github.com/LordMathis/tcardgen">tcardgen</a> to generate the cover images for my posts. It
works, but it&rsquo;s another command to remember to run whenever I write a new post, and the generated images end up
committed to the repo. Also it was some code I needed to &ldquo;maintain&rdquo;, I&rsquo;m always a fan of deleting code.</p>
<p>Recently, as part of redesigning my blog, I moved to generating the OG images with Hugo at build time instead.
So lets see how I did that:</p>
<h2 id="assets">Assets</h2>
<p>First we need two assets, a font and a background image:</p>
<div class="lab-neovim" data-code-lines="5" data-code-filename="snippet.txt" data-code-lang="text">
  <div class="lab-code-tab">
    <span class="lab-code-filename" title="snippet.txt">snippet.txt</span>
  </div>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">assets/
</span></span><span class="line"><span class="cl">├── fonts/
</span></span><span class="line"><span class="cl">│   └── SchibstedGrotesk-Bold.ttf
</span></span><span class="line"><span class="cl">└── og/
</span></span><span class="line"><span class="cl">    └── base.png</span></span></code></pre></div>
  <div class="lab-code-bar">
    <b class="lab-code-lang">text</b>
    <span class="lab-code-lines">5 lines</span>
    <span class="lab-code-copy"></span>
  </div>
  <div class="lab-code-command" role="status">"snippet.txt" 5L</div>
</div>
<p>The background is just a solid colour, 1200x630, the size social sites expect for card images.</p>
<div class="lab-neovim" data-code-lines="2" data-code-filename="snippet.sh" data-code-lang="bash">
  <div class="lab-code-tab">
    <span class="lab-code-filename" title="snippet.sh">snippet.sh</span>
  </div>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">mkdir -p assets/og assets/fonts
</span></span><span class="line"><span class="cl">magick -size 1200x630 xc:<span class="s1">&#39;#1e1e2e&#39;</span> PNG32:assets/og/base.png</span></span></code></pre></div>
  <div class="lab-code-bar">
    <b class="lab-code-lang">bash</b>
    <span class="lab-code-lines">2 lines</span>
    <span class="lab-code-copy"></span>
  </div>
  <div class="lab-code-command" role="status">"snippet.sh" 2L</div>
</div>
<h2 id="generate-the-image">Generate the Image</h2>
<p>Then a partial, <code>layouts/partials/og-image.html</code>, which draws the text on top of the background:</p>
<div class="lab-neovim" data-code-lines="22" data-code-filename="snippet.html" data-code-lang="go-html-template">
  <div class="lab-code-tab">
    <span class="lab-code-filename" title="snippet.html">snippet.html</span>
  </div>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go-html-template" data-lang="go-html-template"><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="nx">$background</span><span class="w"> </span><span class="o">:=</span><span class="w"> </span><span class="nx">resources</span><span class="na">.Get</span><span class="w"> </span><span class="s">&#34;og/base.png&#34;</span><span class="w"> </span><span class="cp">-}}</span>
</span></span><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="nx">$font</span><span class="w"> </span><span class="o">:=</span><span class="w"> </span><span class="nx">resources</span><span class="na">.Get</span><span class="w"> </span><span class="s">&#34;fonts/SchibstedGrotesk-Bold.ttf&#34;</span><span class="w"> </span><span class="cp">-}}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="nx">$image</span><span class="w"> </span><span class="o">:=</span><span class="w"> </span><span class="nx">$background</span><span class="na">.Filter</span><span class="w"> </span><span class="o">(</span><span class="nx">images</span><span class="na">.Text</span><span class="w"> </span><span class="na">.Title</span><span class="w"> </span><span class="o">(</span><span class="nx">dict</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;font&#34;</span><span class="w"> </span><span class="nx">$font</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;size&#34;</span><span class="w"> </span><span class="nx">56</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;color&#34;</span><span class="w"> </span><span class="s">&#34;#cdd6f4&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;x&#34;</span><span class="w"> </span><span class="nx">64</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;y&#34;</span><span class="w"> </span><span class="nx">100</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;linespacing&#34;</span><span class="w"> </span><span class="nx">12</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="o">))</span><span class="w"> </span><span class="cp">-}}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="nx">$image</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">$image</span><span class="na">.Filter</span><span class="w"> </span><span class="o">(</span><span class="nx">images</span><span class="na">.Text</span><span class="w"> </span><span class="nx">site</span><span class="na">.Title</span><span class="w"> </span><span class="o">(</span><span class="nx">dict</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;font&#34;</span><span class="w"> </span><span class="nx">$font</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;size&#34;</span><span class="w"> </span><span class="nx">28</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;color&#34;</span><span class="w"> </span><span class="s">&#34;#cba6f7&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;x&#34;</span><span class="w"> </span><span class="nx">64</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="s">&#34;y&#34;</span><span class="w"> </span><span class="nx">540</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="o">))</span><span class="w"> </span><span class="cp">-}}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="nx">$filename</span><span class="w"> </span><span class="o">:=</span><span class="w"> </span><span class="k">printf</span><span class="w"> </span><span class="s">&#34;og/%s.png&#34;</span><span class="w"> </span><span class="o">(</span><span class="nx">md5</span><span class="w"> </span><span class="na">.RelPermalink</span><span class="o">)</span><span class="w"> </span><span class="cp">-}}</span>
</span></span><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="nx">return</span><span class="w"> </span><span class="o">(</span><span class="nx">resources</span><span class="na">.Copy</span><span class="w"> </span><span class="nx">$filename</span><span class="w"> </span><span class="nx">$image</span><span class="o">)</span><span class="w"> </span><span class="cp">-}}</span></span></span></code></pre></div>
  <div class="lab-code-bar">
    <b class="lab-code-lang">go-html-template</b>
    <span class="lab-code-lines">22 lines</span>
    <span class="lab-code-copy"></span>
  </div>
  <div class="lab-code-command" role="status">"snippet.html" 22L</div>
</div>
<p><code>images.Text</code> <sup id="fnref:1"><a href="https://haseebmajid.dev/posts/2026-11-17-how-i-generate-open-graph-images-with-hugo/#fn:1" class="footnote-ref" role="doc-noteref">1</a></sup> draws the post title near the top, then the site title near the bottom, using our font. Finally
<code>resources.Copy</code> <sup id="fnref:2"><a href="https://haseebmajid.dev/posts/2026-11-17-how-i-generate-open-graph-images-with-hugo/#fn:2" class="footnote-ref" role="doc-noteref">2</a></sup> publishes the image under a filename based on the page path, so each page gets its own image
and the processed images are cached between builds.</p>
<h2 id="add-the-meta-tags">Add the Meta Tags</h2>
<p>Then in my head template, in place of the old tags pointing at <code>images/cover.png</code>:</p>
<div class="lab-neovim" data-code-lines="6" data-code-filename="snippet.html" data-code-lang="go-html-template">
  <div class="lab-code-tab">
    <span class="lab-code-filename" title="snippet.html">snippet.html</span>
  </div>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go-html-template" data-lang="go-html-template"><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="nx">$image</span><span class="w"> </span><span class="o">:=</span><span class="w"> </span><span class="nx">partial</span><span class="w"> </span><span class="s">&#34;og-image.html&#34;</span><span class="w"> </span><span class="na">.</span><span class="w"> </span><span class="cp">-}}</span>
</span></span><span class="line"><span class="cl"><span class="p">&lt;</span><span class="nt">meta</span> <span class="na">property</span><span class="o">=</span><span class="s">&#34;og:image&#34;</span> <span class="na">content</span><span class="o">=</span><span class="s">&#34;</span><span class="cp">{{</span><span class="w"> </span><span class="nx">$image</span><span class="na">.Permalink</span><span class="w"> </span><span class="cp">}}</span><span class="s">&#34;</span><span class="p">&gt;</span>
</span></span><span class="line"><span class="cl"><span class="p">&lt;</span><span class="nt">meta</span> <span class="na">property</span><span class="o">=</span><span class="s">&#34;og:image:width&#34;</span> <span class="na">content</span><span class="o">=</span><span class="s">&#34;</span><span class="cp">{{</span><span class="w"> </span><span class="nx">$image</span><span class="na">.Width</span><span class="w"> </span><span class="cp">}}</span><span class="s">&#34;</span><span class="p">&gt;</span>
</span></span><span class="line"><span class="cl"><span class="p">&lt;</span><span class="nt">meta</span> <span class="na">property</span><span class="o">=</span><span class="s">&#34;og:image:height&#34;</span> <span class="na">content</span><span class="o">=</span><span class="s">&#34;</span><span class="cp">{{</span><span class="w"> </span><span class="nx">$image</span><span class="na">.Height</span><span class="w"> </span><span class="cp">}}</span><span class="s">&#34;</span><span class="p">&gt;</span>
</span></span><span class="line"><span class="cl"><span class="p">&lt;</span><span class="nt">meta</span> <span class="na">name</span><span class="o">=</span><span class="s">&#34;twitter:card&#34;</span> <span class="na">content</span><span class="o">=</span><span class="s">&#34;summary_large_image&#34;</span><span class="p">&gt;</span>
</span></span><span class="line"><span class="cl"><span class="p">&lt;</span><span class="nt">meta</span> <span class="na">name</span><span class="o">=</span><span class="s">&#34;twitter:image&#34;</span> <span class="na">content</span><span class="o">=</span><span class="s">&#34;</span><span class="cp">{{</span><span class="w"> </span><span class="nx">$image</span><span class="na">.Permalink</span><span class="w"> </span><span class="cp">}}</span><span class="s">&#34;</span><span class="p">&gt;</span></span></span></code></pre></div>
  <div class="lab-code-bar">
    <b class="lab-code-lang">go-html-template</b>
    <span class="lab-code-lines">6 lines</span>
    <span class="lab-code-copy"></span>
  </div>
  <div class="lab-code-command" role="status">"snippet.html" 6L</div>
</div>
<p>The generated images end up under <code>public/og/</code>, essentially we create them during build time only. Which is probably
the way I should&rsquo;ve always done it to be fair.</p>
<div class="footnotes" role="doc-endnotes">
<hr>
<ol>
<li id="fn:1">
<p><a href="https://gohugo.io/functions/images/text/">https://gohugo.io/functions/images/text/</a>&#160;<a href="https://haseebmajid.dev/posts/2026-11-17-how-i-generate-open-graph-images-with-hugo/#fnref:1" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p>
</li>
<li id="fn:2">
<p><a href="https://gohugo.io/functions/resources/copy/">https://gohugo.io/functions/resources/copy/</a>&#160;<a href="https://haseebmajid.dev/posts/2026-11-17-how-i-generate-open-graph-images-with-hugo/#fnref:2" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p>
</li>
</ol>
</div>
]]></content:encoded>
    </item>
    
  </channel>
</rss>
