How to disavow backlinks: file format and steps

To disavow backlinks you upload a plain text file, one URL or domain per line, through the disavow links tool in Google Search Console. Google says most sites never need it. Here are the exact file rules, the steps and the cases where it is worth doing.

In short

  • Google's help page, read in October 2026, says to disavow only when you have a considerable number of spammy, artificial or low-quality links and they have caused, or are likely to cause, a manual action.
  • The disavow file is a .txt file in UTF-8 or 7-bit ASCII, with one URL or one domain per line and a limit of 100,000 lines and 2MB.
  • A whole domain is disavowed with the prefix domain, for example domain:shadyseo.com, and lines starting with a hash mark are comments.
  • Each upload replaces the previous list for that property, and Google says it can take a few weeks for the list to be incorporated.
  • Google's John Mueller said in September 2026 that the tool does have effects, which means disavowing good links can cost you rankings.

You disavow backlinks by uploading a plain text file to the disavow links tool in Google Search Console. The file lists one URL or one domain per line, and Google then ignores those links when it assesses your site. The upload takes a few minutes. Deciding what goes in the file is the hard part, and for most sites the right answer is nothing. That is worth holding on to while you read the mechanics, because the format is simple enough that it is tempting to fill the file just because you can.

We read Google’s Search Console help page on disavowing links on 4 October 2026. The rules below are quoted from it, and where another source is used it is named. Google can change a help page without notice, so if you are reading this some time after that date and about to upload a file for a site that matters, open the help page and check the limits against what is written here.

Check first whether you should

Google’s help page sets two conditions, and both must be true. The first is “You have a considerable number of spammy, artificial, or low-quality links pointing to your site.” The second is “The links have caused a manual action, or likely will cause a manual action, on your site.” The second condition does most of the work. Plenty of sites meet the first, since almost every site collects junk links over time, but few can say that those links have caused, or are likely to cause, a manual action. The same page calls disavowing “an advanced feature” that “should only be used with caution” and says that used incorrectly it “can potentially harm your site’s performance in Google Search results”. It also says “most sites will not need to use this tool”.

In practice that leaves two situations. The first is a manual action for unnatural links, visible in Search Console. The second is a history of paid or self-made links at a scale that could lead to one. Random spam from scrapers and unknown foreign sites is not on the list. Google’s systems ignore it, and the “toxic” scores in SEO tools are the tools’ own invention, so a long list of flagged domains in a tool is not evidence that either condition is met. The backlink audit lesson covers how to tell the two apart.

The tool is not harmless, and that is the other half of the decision. Google’s John Mueller said in September 2026, as reported by Search Engine Roundtable: “it has its place & time, it does have effects.” If the file has effects, they apply to every line in it, including the lines you added without much thought. If you disavow links that were helping, you lose that help, and nothing in the tool will tell you that this is what happened. The safe habit is to treat each line as a claim you could defend: this link was made by us or for us, and it is of the kind that leads to a manual action.

The file rules

The format is strict but short. Every rule in the table is from Google’s help page, and the tool will reject a file that breaks them, so it is quicker to get them right before the upload than to work back from an error message.

Rule What Google’s help page says
File type A text file with a name ending in .txt
Encoding UTF-8 or 7-bit ASCII
Layout “Specify one URL or domain to disavow per line”
Whole domain Prefix the line with domain, for example domain:example.com
Comments Start a line with a # mark. Google ignores those lines
URL length Maximum 2,048 characters
File size Maximum 100,000 lines, including blank and comment lines, and 2MB
Lists per property One. A new upload replaces the existing list

Google’s own example looks like this:

# Two pages to disavow
http://spam.example.com/stuff/comments.html
http://spam.example.com/stuff/paid-links.html
# One domain to disavow
domain:shadyseo.com

A URL line disavows the link from that one page. A domain line disavows links from every page on that domain. For link sellers, networks and spam sites, the domain line is the practical choice, because the same link often appears on several URLs of the site: the article itself, then a tag page, an archive page and a paginated listing that all repeat it. A file of URL lines would have to chase every one of those copies, and would miss the ones that appear later. The limit of 100,000 lines counts blank and comment lines as well, which is one more reason to prefer one domain line to dozens of URL lines for the same site.

How to build the list and upload it

Building the list is where the care goes. Work through it in this order, and resist the urge to start from a tool’s export of “bad” links.

  1. Export your links. Download the links report from Search Console, and add an export from a backlink tool if you have one, since Search Console shows a sample. Our backlink tools comparison lists the options.
  2. Mark the links you created. Start with records: invoices, vendor reports, old agency spreadsheets. Paid posts, private blog network links, bulk comment and profile links and keyword-anchor widgets are the usual candidates.
  3. Try removal first where it is realistic. For a manual action, Google’s manual actions help page tells you to contact the site owner and ask for the link to be removed, and to disavow what you cannot get removed.
  4. Leave everything else alone. If you cannot say why a link is manipulative, it does not belong in the file.
  5. Write the file. Use domain lines for sites that exist to sell links, and URL lines only where one page on an otherwise good site is the problem. Add comments with dates so the next person understands each block.
  6. Save as .txt in UTF-8 and check that no line has stray spaces or quotation marks.

The upload itself is short once the file exists. Open the disavow links tool, which is a separate page and does not appear as an item in the Search Console menu. Then select the property. Google’s help page says you must be an owner of the property and that domain properties are not supported, so choose a URL-prefix property. Upload the file, fix any errors the tool reports, and upload again until it is accepted. The one step that catches people is the replacement rule: if the property already has a list, the new file replaces it. Download the existing list first and add to it, or you will silently drop the old entries, and the links a previous owner disavowed for good reason will be back in play without anyone having decided that.

Google’s help page says “it can take a few weeks for Google to incorporate your list”. The links will still appear in your Search Console links report afterwards. That is expected, because the file changes how Google treats the links and has no bearing on whether it lists them. It does mean you cannot use the links report to confirm that the disavow has been applied, so the dated comments in the file and a saved copy of each upload are the only record you will have of what was submitted and when.

After a manual action

If you are disavowing because of a manual action, the file is one part of the process and not the end of it. Google’s manual actions help page says that once the artificial links are removed or disavowed, you select Request Review and describe your fixes. It adds that most reviews “can take several days or weeks”, and that link-related requests may take longer than usual. So the timetable has two waits in it: the review itself, and before that the work of asking site owners to take links down, which the same help page tells you to do before you fall back on the file.

Keep a record of the removal emails you sent, with dates and any replies. The review asks you to describe your fixes, and a record of who was contacted is the simplest way to describe the removal work for the links that could not be taken down and ended up in the file. Google link penalties and recovery covers the reconsideration request itself, including what to put in it.

Common mistakes and how to undo them

The most frequent mistake is disavowing by tool score. A list generated from a “toxic” filter usually includes harmless links and sometimes good ones, and given Mueller’s comment that the tool does have effects, the good ones are a real cost. The second is uploading a partial file. Each upload replaces the last, so always work from the current list. The third is using URL lines for link farms: the same link reappears on tag, archive and paginated pages, and only the domain line covers all of them.

Two further mistakes are about timing and expectations. One is disavowing after a spam blast. A sudden wave of junk links is normally ignored, and negative SEO and link attacks sets out when action is justified. The other is expecting a bounce. If rankings fell because Google stopped counting links, a disavow restores nothing, because the file can only ask Google to ignore links, and those links are being ignored already. Mueller said in September 2026 that recovery “can take quite some time, sometimes many months”.

A disavow can be reversed, which takes some of the fear out of a mistake but none of the delay. To restore some links, upload a new file without those lines. To remove everything, open the tool, choose the property and select Cancel Disavowals. Expect the same delay of weeks before the change is picked up. Because of that delay, an error in the file costs you the weeks it was live plus the weeks it takes to be withdrawn, which is the practical argument for a short, defensible file over a long, cautious-looking one.

Will the tool go away, and where to go next

Possibly. Mueller is quoted by Search Engine Land as saying of the tool: “At some point, I’m sure we’ll remove it.” Bing removed its own disavow feature in October 2023, according to the Bing Webmaster blog. As of October 2026 Google’s tool is live and no removal date has been announced. Nothing here tells you when or whether that will change, so the sensible position is to use the tool for the cases Google’s help page describes while it exists, and to keep your own record of bought and built links, which stays useful with or without it.

If you are not sure whether your links are a problem at all, start with what counts as link spam. To catch risky links early, before they add up to the “considerable number” that Google’s first condition describes, set up backlink tracking. Terms such as manual action and disavow are defined in the glossary.

Common questions

Where is the disavow tool in Google Search Console?

It is not in the main menu. It sits on its own disavow links tool page, where you choose a property and upload a text file. Google's help page says domain properties are not supported.

What is the format of a disavow file?

A plain .txt file encoded in UTF-8 or 7-bit ASCII, with one URL or domain per line. Use the prefix domain to disavow a whole domain, and start a line with a hash mark to add a comment.

How long does a disavow take to work?

Google's help page says it can take a few weeks for Google to incorporate the list. John Mueller said in September 2026 that recovery from link problems can take many months.

Should I disavow toxic links flagged by an SEO tool?

Usually not. Google says most sites will not need the tool, and its systems ignore ordinary spam links. Disavow links you built or bought that are likely to cause a manual action, or that already have.

Can I undo a disavow?

Yes. Upload a new file without the lines you want to restore, or use Cancel Disavowals in the tool to remove the whole list for that property.

Vendors to look at

  • BazoomEditor's pick

    Sponsored content and link marketplace, managed service

  • MotherlinkEditor's pick

    Backlink services, guest posts, niche edits, full SEO