A restaurant chain's new marketing hire couldn't understand why organic traffic had flatlined completely three months after a site relaunch, with rankings for even the business's own name quietly disappearing. The cause turned out to be a single leftover line in the site's robots.txt file — 'Disallow: /' — a rule meant to keep search engines out of the staging environment during development, that had simply never been removed when the site went live. It had been blocking every search engine from crawling the entire site for the full three months.
What robots.txt actually does, and doesn't do
The robots.txt file, sitting at the root of a domain, gives instructions to well-behaved crawlers about which parts of a site they're permitted to request. It's a voluntary standard — compliant crawlers like Googlebot and Bingbot respect it, but it isn't a security or access-control mechanism, and it doesn't prevent a page from ever appearing in search results if that page is linked to from elsewhere; a disallowed page can still show up in results with just its URL and no description, if enough external signals point to it. Robots.txt controls crawling, not indexing directly, which is a distinction that trips people up constantly.
The staging-leftover mistake, and why it happens so often
The single most damaging and most common robots.txt error is exactly the one above: a blanket disallow rule, appropriate for a development or staging environment where nobody wants search engines crawling unfinished work, that survives the deployment to the live production site because nobody double-checked the file after launch. This is disproportionately common precisely because it works exactly as intended during development — nothing looks broken until organic traffic and rankings start disappearing weeks or months later, by which point the cause isn't obviously connected to a launch that already happened.
- 'Disallow: /' left over from a staging environment — blocks the entire site from being crawled
- Blocking CSS or JavaScript files needed for a search engine to properly render and evaluate the page, which can cause rendering issues that affect how the page is understood
- Disallowing URL paths that are actually meant to rank, out of an overcautious guess at what should be excluded
- Conflicting rules across multiple user-agent blocks in the same file, where a more specific block accidentally overrides a broader intended allowance
- A missing or unreachable robots.txt file returning a server error instead of a valid response, which some crawlers interpret cautiously rather than assuming full access
A quick verification anyone can run
- Visit yourdomain.com/robots.txt directly in a browser and read the actual live file — don't rely on memory of what it's supposed to say
- Confirm there's no blanket 'Disallow: /' rule under the user-agent groups relevant to major search engines, unless the entire site is genuinely meant to be excluded
- Use Search Console's URL Inspection tool on a handful of important pages to confirm they're reported as crawlable, not blocked by robots.txt
- Check that CSS and JavaScript directories aren't disallowed, since blocking them can prevent a search engine from properly rendering the page even if the HTML itself is accessible
- Re-check the live robots.txt file immediately after any site migration, redesign, or platform change — this is the single highest-risk moment for a staging rule to leak into production
Robots.txt is one of the smallest files on a website and one of the very few capable of silently switching off all of a site's organic visibility with a single misplaced line.
Why this deserves a spot on every launch checklist
Because this mistake produces no error message, no broken page, no visible symptom on the site itself, it's the kind of issue that only gets caught by someone deliberately checking for it — it doesn't announce itself the way a broken link or a missing image would. Adding a robots.txt check to the standard post-launch and post-migration checklist, rather than trusting that it was handled correctly once, is the cheapest insurance available against one of the most damaging technical SEO mistakes a site can make. This exact check is one of the first things reviewed in NetWebMedia's free audit.
Does your business show up when AI answers?
ChatGPT, Claude, Perplexity and Google's AI Overviews are already answering the questions your customers ask. The $49 AI Visibility Scan shows you where you're cited, where you're invisible, and the three changes that move you first — a written report in your inbox within 48 hours. If nothing in it is actionable, you don't pay.
Run the $49 AI Visibility Scan →Share this article
Comments
Leave a comment