What Is Disavow File?

Flavio AmielWritten byFlavio Amiel Founder, Roborank
Updated July 15, 2026

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.

Key Takeaways

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:

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 thing people get wrong

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?
It is a plain-text file you upload through Google’s disavow links tool that asks Google to ignore specific incoming links or entire linking domains when it evaluates your site. It lists one URL or domain per line, using a ‘domain:’ prefix to disavow a whole domain.
Do I need to disavow links?
Most sites do not. Google says it can usually assess which links to trust without help. It recommends disavowing only if you have a considerable number of spammy or artificial links AND those links have caused, or are likely to cause, a manual action against your site.
What format does a disavow file use?
A plain-text .txt file, one URL or domain per line. Prefix a line with ‘domain:’ to disavow an entire domain, and start a line with ‘#’ to add a comment. It must be UTF-8 or 7-bit ASCII encoded, with a maximum of 100,000 lines and 2MB.
How long does a disavow file take to work?
It is not instant. Google needs to recrawl and reprocess the affected pages before your disavow list is incorporated, which typically takes several weeks. Disavowing a link does not remove it from the web — it only tells Google to ignore it for your site.

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

  1. Disavow links to your site — Search Console HelpGoogle Search Console Help
  2. December 2022 link spam update releasing for Google SearchGoogle Search Central Blog
Roborank does this

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.