Meta-Tags | mikePietsch.com

27.8 Hugo SEO Partial Template Boilerplate

Right, let’s get our hands dirty. You’re using Hugo, which means you’re smart enough to appreciate a static site, but now you need to speak Google’s language. SEO isn’t magic; it’s plumbing. It’s about making sure the crawlers can find all your pages, understand what they’re about, and not get lost in the parts of your site you’d rather they ignore. We do this with three core tools: a sitemap, a robots.txt file, and a heap of meta tags in your <head>. Instead of pasting this into every single layout file, we’re going to be adults about it and create a single, glorious partial template.

27.7 Canonical URLs and Handling Duplicate Content

Right, let’s talk about one of the most misunderstood and yet utterly critical concepts in SEO: the canonical URL. Think of it as the internet’s way of dealing with its own rampant plagiarism problem, but where the original author gets to politely point a finger and say, “No, that one over there is the real me.” Here’s the core issue: duplicate content. Search engines hate it. They want to show you ten unique results, not the same article from ten slightly different URLs. If you have the same content accessible via https://example.com/dress, https://example.com/products/dress, and https://example.com/dress?color=red, Google has to pick one to show in search results. If you don’t tell it which one is the “master” version, it’ll guess. And trust me, you do not want a search engine algorithm guessing your business priorities. The canonical URL (rel="canonical") is your way of making that decision for them. It’s not a directive; it’s a strong signal. A very strong, “I’d really prefer it if you’d listen to me on this one, buddy” signal.

27.6 JSON-LD Structured Data

Right, let’s talk about JSON-LD. This is where we stop politely asking search engines to understand our content and start telling them exactly what it is, in a language they’re desperate to speak. Think of it less like a meta description and more like handing a librarian a detailed card catalog entry for your page instead of hoping they can guess the book’s topic from its cover art. The “LD” stands for “Linked Data,” which sounds intimidatingly academic but is really just a fancy way of saying “data with context.” We use a shared vocabulary (from schema.org) so that when I say “name,” Google knows I mean the title of this article, not my dog’s name. We format it in JSON because, well, everything speaks JSON these days. It’s the lingua franca of data on the web, and crucially, we can slap it right into the <head> of our HTML without mucking up our beautiful semantic markup.

27.5 Twitter Card Tags

Right, let’s talk about Twitter Cards. You know those fancy, expanded tweets you see with big images, titles, and descriptions? The ones that look like a proper piece of content instead of a sad text message lost in the feed? That’s what we’re building. And no, simply sharing your URL is not enough. Twitter, in its infinite wisdom, needs you to explicitly tell it how to make your content look good. It’s like having a world-class chef in your kitchen but you still have to hand him the recipe for a grilled cheese.

27.4 Open Graph Tags: og:title, og:image, og:description

Right, let’s talk about making your website look good when it gets shared. You know those rich, informative links that pop up on Slack, Facebook, or LinkedIn? The ones with a nice title, a description, and a big, beautiful image? That doesn’t happen by magic. That happens because someone (hopefully you) bothered to add Open Graph tags. Think of it this way: by default, when a social media scraper looks at your page, it’s like a stranger judging a book by its cover. The Open Graph protocol is you designing that cover. It’s your way of saying, “No, no, don’t just use the first image you find—use this one. And for heaven’s sake, use this title, not the one with twenty hyphens in it.” It’s the single most effective thing you can do to control your brand’s appearance in social feeds.

27.3 HTML Meta Tags: description, keywords, author

Right, let’s talk about HTML meta tags. This is where a lot of people start their SEO journey, and consequently, where a lot of people get it spectacularly wrong. We’re going to cut through the noise. Think of these tags as little notes you can slip to search engines. They’re not a magic wand, but used correctly, they’re incredibly powerful. First, a crucial reality check: Google hasn’t used the keywords meta tag for web ranking in over a decade. I know, I know. Your client’s “SEO expert” from 2004 is screaming. It’s true. The reason is simple: it was comically easy to spam. You’d just stuff a tag with every vaguely related word (“kitten, puppy, mortgage, stock tips, free ipod”). Search engines wised up. If you include it today, it does precisely nothing for your ranking. The only reason you might still add it is for internal site search tools that might use it, but that’s a fringe case. Consider it a historical artifact.

27.2 robots.txt: Controlling Crawler Access

Right, let’s talk about robots.txt. This is the file where you, the website owner, get to politely ask search engine crawlers (or “robots”) to please stay out of certain parts of your digital house. I say “politely ask” because that’s the crucial bit everyone forgets: a robots.txt file is a set of guidelines, not a set of enforced rules. It’s the “Employees Only” sign on a door. It keeps honest people honest, but a burglar isn’t going to read it and suddenly decide to be a law-abiding citizen. Malicious scrapers and some less-scrupulous bots will merrily ignore it. Its real audience is the well-behaved crawlers from Google, Bing, and the like.

27.1 Automatic Sitemap Generation and Customization

Right, let’s talk about sitemaps. You’ve probably heard the phrase “just install a plugin” and been done with it. And for a simple blog, that’s fine. But you and I aren’t building simple blogs, are we? We’re building complex, dynamic beasts with custom post types, user-generated content, and all sorts of weirdness. Plugins often guess wrong. They include things they shouldn’t and, more dangerously, exclude things they absolutely should not. So we’re going to do it right: we’re going to generate our sitemaps automatically, and we’re going to tell them exactly what to do.