Developer SEO guide
SEO for developers: what to build into the code
Most technical SEO problems are introduced in a pull request. Most can be caught there too.

350+businesses served
8countries
7+years
In short
The most useful SEO tools for web developers are the ones you can run in a release pipeline: curl for status codes and headers, Google Search Console for indexing, a crawler for internal links and a Lighthouse run for speed. Add generators for schema, hreflang and llms.txt. Then make the checks part of every deploy.
Rather have it done for you? See our SEO service, from $1,500.
On this page 6 sections
Treat SEO as a set of testable requirements
Marketing teams ask for SEO as a list of wishes. Developers get better results by turning it into acceptance criteria. A page either returns a 200 or it does not. A canonical tag either points at the right URL or it does not. Everything below can be written as a test.
This page is for people who write the code. If you need the full audit list instead, use our technical SEO checklist.
The developer's SEO table
| Concern | Decision to make | How to verify |
|---|---|---|
| Rendering | Server-render or pre-render content that must rank; use client-side only for interactions | View the raw HTML source and check the main text is there |
| Status codes | 200 for live pages, 301 for permanent moves, 404 or 410 for gone, never 200 on an error page | curl -sI example.com/path/ and read the first line |
| Canonical URLs | One canonical per page, absolute, matching the version you want indexed | Search source for rel canonical on each template |
| Titles and descriptions | Generate unique values per page from data, not one site-wide string | Crawl and look for duplicates |
| Internal links | Use real anchor elements with href, not click handlers or buttons | Crawl without JavaScript and compare the link count |
| Robots and noindex | Staging blocked, production open, and the flag controlled by environment | Check headers and meta robots after each deploy |
| Redirects | Map old to new URLs one to one before a migration | Run the list through a bulk checker and count chains |
| Structured data | Output JSON-LD from the same data as the visible page | Rich Results Test on one URL per template |
| Performance | Reserve image space, defer scripts, ship less JavaScript | Field data for Largest Contentful Paint and Interaction to Next Paint |
If you want more detail, read our guide to SEO for a GitHub Pages site.
Rather have it done for you?Talk to a person now, or ask for a fixed quote. We reply within one working day.
A release checklist you can add to your pipeline
- Block staging, open productionUse an environment variable that sets noindex and robots rules on non-production builds, and a test that fails if production ever serves noindex.
- Snapshot before a template changeSave titles, canonicals, headings and status codes for a sample of URLs, then diff them after deploy.
- Test redirects in CIKeep the redirect map as data. Test that each old URL answers 301 to the right target in one hop.
- Validate generated sitemapsCheck that they list only canonical, indexable, 200 URLs and use the correct domain.
- Watch Search Console after releaseCheck Pages (indexing), crawl stats and Core Web Vitals for the days after a deploy. Rollback is easier on day one than on day twenty.
A bug we see often: staging rules reach production
A common sequence. A team builds on a staging domain with a blanket noindex. The code is promoted and the flag goes with it. Traffic falls over the next two weeks, but nobody connects it to the release.
Detection takes a minute. Run curl -sI against the live page and read the response headers for an X-Robots-Tag. View the source for a robots meta tag. Open the URL Inspection tool in Search Console and read whether indexing is allowed. Fix the flag, redeploy, then request indexing for the key URLs. This is an illustration of a pattern, not a client case.
Framework notes
Next.js and similar frameworks give you server rendering and metadata functions, but defaults are not magic. Check each route type: dynamic routes, paginated lists and locale variants often miss canonicals or hreflang. For Next.js details, see our guide to SEO in Next.js. Single-page apps that render only in the browser can still be indexed, but rendering is queued and can lag, so pages that must rank should not depend on it.
If you build a developer product
Documentation is usually the strongest search asset a developer tool has. Give every error message and API method a stable URL, keep versions clear with canonicals pointing to the current version, and write task-based pages such as how to authenticate with a given language. Searchers paste error text, so include it verbatim in headings or the first paragraph.
For a technical review of a live site, see our technical SEO service or send your stack through our contact page for a fixed quote.
Related: Ahrefs or Semrush, if you are choosing a paid SEO tool.
Sources: Google Search Central: JavaScript SEO basics.
Updated 20 November 2026
Questions, answered
Something else on your mind? Ask us directly or WhatsApp us. We reply within one working day.
Can Google index a JavaScript site?
Should I use a 301 or a 302 redirect?
Do hash fragments in URLs work for SEO?
How many redirect hops are acceptable?
Who owns SEO on a team, developers or marketers?
Which SEO tool should a web developer start with?
Keep exploring
Technical SEO checklist
Most technical SEO lists treat every item as equal. This one sorts checks into four levels, from problems that remove pages from Google to polish…
ServiceTechnical SEO services for sites that will not index
If good pages are missing from Google, or rankings fell after a rebuild, the cause is usually technical. We find it in your Search Console and fix it…
PlatformNext.js SEO: how to make a React site easy for Google to read
Next.js can produce very fast, crawlable pages. It can also hide content from crawlers if the wrong rendering choice is made. This is how we check.
See how Google and AI see your site.
A free SEO and AI visibility check with the top fixes, within one working day. No obligation.








