Skip to content
snowkit

kits / search-and-share

v1.0.0

Search and Share

Head tags, robots.txt, sitemaps, structured data and share image sizes so search engines and chat apps show your site properly.

search-and-shareREADME.md

Markdown · 3.7 KB

Search and Share

Version 1.0.0

Everything a site needs so search engines can find and understand its pages, and so links look right when people share them. It has a complete head template, robots.txt and sitemap files, structured data templates for eight common page types, a share image size table with safe zones, a guide to writing titles and descriptions, and two checklists: one for each page and one for launch and indexing. Every JSON and XML file is valid as shipped.

Who it's for

  • Site owners launching a new site or relaunching an old one
  • Developers who build sites for clients and want a repeatable SEO and sharing setup
  • Marketers who need to brief a developer on exactly which tags and files to add
  • Anyone whose links show a blank card or the wrong image in chat apps

No SEO background is needed. Each file explains what to change and why.

How to use it in 5 minutes

  1. Open head-tags.html, copy the tags into your page template and replace the [placeholders]. Read head-tags-guide.md for what you can remove.
  2. Copy robots/robots.txt to your site root and change the paths and sitemap URL.
  3. Make a 1200 x 630 px share image using share-image-sizes.md, and point og:image at it.
  4. Pick the structured data templates that match your pages from structured-data/ and add them.
  5. Before launch, work through launch-indexing-checklist.md from the top.

File map

FileWhat it is
README.mdThis file
LICENSE.txtMIT licence
CHANGELOG.mdVersion history
head-tags.htmlComplete head template: title, description, canonical, robots, Open Graph, X card, theme colour, icons and a basic JSON-LD block
head-tags-guide.mdWhat each tag in the template does, which ones to keep, and common mistakes
robots/robots.txtA sensible default robots.txt
robots/robots-variants.mdThe default explained, plus variants for staging, URL parameters, AI training crawlers and crawl delay
sitemaps/sitemap.xmlExample sitemap with image and language alternate extensions
sitemaps/sitemap-index.xmlExample sitemap index for larger sites
sitemaps/sitemap-guide.mdWhat to include, which tags matter, escaping, submitting and checking
structured-data/README.mdHow to add JSON-LD, what each template can do in search, and how to test it
structured-data/organization.jsonOrganization template
structured-data/website.jsonWebSite template with SearchAction
structured-data/article.jsonArticle template
structured-data/product.jsonProduct template with offer, shipping and returns
structured-data/faq-page.jsonFAQPage template
structured-data/breadcrumb-list.jsonBreadcrumbList template
structured-data/local-business.jsonLocalBusiness template with address, location and opening hours
structured-data/software-application.jsonSoftwareApplication template
share-image-sizes.mdShare image sizes by platform, safe zones, text and file advice
titles-and-descriptions.mdLength guidance, patterns and examples for titles, descriptions and share text
seo-checklist.mdOn-page checklist for each page template
launch-indexing-checklist.mdLaunch checklist: staging blocks, migrations, Google Search Console, Bing Webmaster Tools, rendering and canonical issues

A note on limits

This kit covers the technical and on-page groundwork. It can't make a page rank: that depends on the content, the competition and links from other sites, none of which a template controls. Search engines and social platforms change their rules and image sizes regularly, so confirm platform-specific details with their current documentation before a big launch.

Licence

MIT License. See LICENSE.txt.