What Is Disavow File?
A disavow file is a plain-text file uploaded through Google’s disavow links tool that asks Google to ignore specific incoming links or entire linking domains when evaluating a site. It lists one URL or domain per line, with a “domain:” prefix to reject a whole site. Google says most sites never need it, since it can usually assess links on its own.
- Google states plainly that most sites should not use the disavow tool, because it can usually assess which links to trust without guidance.
- Google recommends disavowing only when both conditions hold: you have a considerable number of spammy, artificial, or low-quality links, AND they have caused or will likely cause a manual action.
- The file is plain text (.txt), one URL or domain per line, uses a ‘domain:’ prefix to disavow an entire domain, allows ‘#’ comment lines, and must be UTF-8 or 7-bit ASCII encoded.
- The file is capped at 100,000 lines and 2MB, and changes take weeks to take effect as Google recrawls and reprocesses the affected pages.
How Disavow File Works
A disavow file is how you tell Google, “ignore these links when you judge my site.” You create a plain-text file listing the links or domains you want discounted, then upload it through the disavow links tool in Search Console. From that point Google treats the listed links as if they carry no ranking value for your site — it does not remove them from the web or from anyone else’s view, it just stops counting them for you.
Google is unusually blunt about who should use it. Its documentation says that in most cases Google can assess which links to trust without additional guidance, so most sites will not need this tool. It goes further and labels the feature advanced, warning that using it incorrectly can hurt a site’s performance in search. The recommended trigger is narrow and has two parts that must both be true: you have a considerable number of spammy, artificial, or low-quality links pointing at your site, and those links have caused a manual action, or you have good reason to believe one is imminent. Absent a manual action, disavowing is usually solving a problem you do not have — Google’s SpamBrain systems already nullify most link spam automatically.
File Format
The format is deliberately simple, and Google specifies it exactly:
- Plain text, saved as a
.txtfile. - One URL or domain per line. A bare URL disavows that single page.
domain:prefix disavows an entire domain — for example,domain:example.comrejects every link from that site.#starts a comment. Google ignores anything on a line after a#, which is useful for dating entries or noting why a domain was added.- Encoding must be UTF-8 or 7-bit ASCII.
- Limits: a maximum of 100,000 lines and a 2MB file size.
You upload one file per property, and each upload replaces the previous list entirely — so the file you submit must always be the complete set of links you want ignored, not just the new additions. Because the current file is authoritative, teams usually keep the disavow list in version control alongside dated # comments, so anyone can see when a domain was added and why. A stray deletion in that file quietly re-enables links you meant to keep discounted.
Example of Disavow File
Google’s own documentation gives the canonical structure. A valid file might read:
# Two pages to disavow
http://spam.example.com/stuff/comments.html
http://spam.example.com/stuff/paid-links.html
# One entire domain to disavow
domain:shadyseo.example
The first two lines reject specific pages; the last line rejects an entire domain in one stroke, which is the more common choice because spammy links usually come from every corner of a bad site rather than a single URL. Comment lines document the intent.
Timing matters and is easy to get wrong. Uploading the file does nothing instantly. Google has to recrawl and reprocess the pages containing those links before the disavow takes effect, and its documentation says this can take several weeks. There is no button that says “done” — you upload, then wait for the next crawl cycle to fold your list into how Google sees the site. This also means the tool is a poor fit for emergencies: if you are hoping to reverse a ranking drop by Friday, a disavow file will not do it, and the drop probably was not caused by links you can disavow in the first place.
The disavow tool is one of the few SEO buttons that can genuinely make things worse if you press it wrong. Because it tells Google to permanently ignore links, a careless upload can strip credit from good links you meant to keep — I have seen people disavow whole domains that were sending them real, editorial value. Google’s framing is the tell: it calls this an advanced feature and says the vast majority of sites never need it. So my rule is simple. If you did not build or buy the links, and you have no manual action, do nothing. The file is a scalpel for a self-inflicted wound, not a routine hygiene step you run every quarter because a tool handed you a list.
When Not to Use It
The failure mode is over-use. Because a disavow file permanently discounts whatever you list, a bloated file assembled from a crawler’s toxic backlink report can throw away links that were quietly helping you. This is the opposite of the outcome most people expect: they upload a large list hoping to recover rankings and instead surrender legitimate authority, because a third-party tool cannot know which links Google was already trusting. Google’s position is the safest default: if you did not build the links and you have no manual action, leave the tool alone. Reserve it for cleaning up manipulative links you are genuinely responsible for — a private blog network you once paid into, or a link-buying campaign you inherited — where removal at the source is impossible and a manual action is on the table.
Frequently Asked Questions
What is a disavow file?
Do I need to disavow links?
What format does a disavow file use?
How long does a disavow file take to work?
The Bottom Line
A disavow file is a directive, not a cleanup habit: it instructs Google to discount named links or domains so they cannot influence your rankings. Its format is trivial — a text list with an optional “domain:” prefix — but its judgment is not. Google reserves it for sites carrying manipulative links they built and now face a manual action over. For everyone else, leaving the tool untouched is the recommended choice.
Sources
- Disavow links to your site — Search Console Help — Google Search Console Help
- December 2022 link spam update releasing for Google Search — Google Search Central Blog
Roborank helps you confirm whether you actually have a link problem worth disavowing — or whether Google is already ignoring the links on its own.
Check before you disavow →Rank & Cash — the weekly SEO breakdown
One practical teardown a week on ranking in search and getting cited by AI. No fluff.
