How-To Guides

How to Create a Disavow File: A Step-by-Step Guide

By BacklinkPrice Team · Nov 18, 2026 · Updated Nov 20, 2026 · 11 min read
Illustrated cover for How to Create a Disavow File

To create a disavow file, list one URL or domain per line in a plain .txt file and upload it to Google's Disavow Links tool. Use it only for many spammy links tied to a manual action.

To create a disavow file, write a text file that lists one URL or domain per line, save it with a .txt name, and upload it to Google's Disavow Links tool. Google says most sites never need this file, so build one only when you have many spammy links and a manual action is likely.

Key takeaways

  • A disavow file is a plain .txt file that asks Google to ignore listed links when it judges your site, and it does not delete links from the web.
  • Google says to disavow only when you have many spammy, artificial, or low-quality links and those links have caused a manual action or are likely to cause one.
  • Each line holds one URL or one domain entry, with domain: before a whole domain, and a # at the start of a comment line.
  • As of November 2026, Google caps the file at 100,000 lines, including blank and comment lines, and 2 MB, and caps each URL at 2,048 characters.
  • A new upload replaces the old list for that property, so keep one master file with every entry you still want disavowed.
  • Bing removed its disavow tool in October 2023, so the file you build is for Google only (Search Engine Land, 2023).

What a disavow file is

A disavow file is a plain text file that lists the pages or domains you ask Google not to count when it judges the links that point to your site.

The file is a request, not an order, and it changes nothing on the other sites. The links stay live on the web, and Google says disavowed links still appear in your Links report, so the report will not shrink after you upload.

This guide covers the build itself. For the wider background, see what a disavow file is.

A disavow file is also not a way to lift a ranking drop on its own. It only tells Google which links to leave out of its judgment, and Google still decides how to judge the rest of your link profile.

When you need a disavow file

You need a disavow file only when both of Google's conditions are met: many spammy, artificial, or low-quality links point to your site, and those links have caused a manual action or are likely to cause one.

In most cases, Google says it can assess which links to trust without extra guidance, so most sites will not need this tool at all. A few odd links, or links you did not build and cannot tie to a manual action, are not a reason to build a file.

The common trigger is links you built yourself, or links an SEO you hired built, through paid links or other link schemes that break Google's spam policies. Buying links is against Google's guidelines when the links pass ranking credit, so those are the links to hunt for first.

Google's spam policies list paid links, excessive link exchanges, automated link building, low-quality directory links, and hidden links in widgets as link spam. If your audit finds those patterns at scale, and removal fails, a disavow file is the next step.

If you are unsure whether your links count as spammy, see should you disavow spammy links in 2026.

How to create a disavow file, step by step

Create the file in six steps: check for a manual action, export your links, ask for removal, write the file, upload it, and keep one master copy.

Step 1: Check for a manual action

Open Search Console and check the Manual actions report before you write anything, because a manual action for unnatural links sets the scope of the cleanup. Google's disavow page starts from the same place: if you have a manual action for unnatural links, try to remove the links, and disavow only what you cannot remove.

For what the action means, see what a Google manual action for unnatural links is.

In Search Console, open the Links report and use the export button to download the data. Google's help page tells you to remove any URLs from the downloaded file that you do not want to disavow, so treat the export as a draft, not a finished list.

Add data from a backlink tool as well, because Search Console shows the links Google knows about, while a crawler-based tool can surface links Google has not listed. Sort the combined list by domain so you can judge whole sites at once instead of link by link.

Google recommends that you remove as many spammy or low-quality links from the web as possible before you disavow anything. Contact each site owner, ask for the link to be removed, and keep a short log with the date, the site, and the reply.

If the owner will not remove the link, ask for a nofollow or sponsored tag instead, since a qualified link passes no ranking credit. For the full removal workflow, see how to remove toxic backlinks.

Step 4: Write the file

Open a plain-text editor, such as Notepad or TextEdit, and save the file with a .txt name. Word processors add formatting that Google will not accept, so never build the file in a .docx document.

Put one URL or one domain entry on each line. Use domain: before a whole domain, use the full URL for a single page, and start comment lines with # so you can note why each entry is there.

#Paid links we could not get removed
https://spam.example.com/stuff/paid-links.html
#Whole domain is spam
domain:shadyseo.com

Disavow at domain level when the whole site is spam, and at URL level only when one page on a sound site is the problem. Semrush says domain-level disavow is almost always better, because a URL-level entry can miss the same link on a second page, such as example.com/home and example.com/home.html.

Step 5: Upload the file to Google

Go to the Disavow Links tool page, pick the URL-prefix property for your site, and upload the .txt file. The tool does not support Domain properties, so add a URL-prefix property first if that is all you hold.

You must be a property owner to upload a list, and you can post one list for each property you own. If the file has errors, Google shows the errors at once and keeps your old list, so fix the file and try again.

A new upload replaces the old list for that property instead of adding to it. The list also applies to child properties, so a list on example.com covers m.example.com, while http and https versions need their own lists.

Step 6: Keep one master file

Keep one master copy of the file on your own computer, because you can only have one disavow file at a time per website. Semrush gives the same warning: to add 3 links to a file of 10, reformat the file to hold all 13 links and upload it again.

If you build the list in Semrush Backlink Audit, use the Audit tab and Move to Disavow list, then export it with the Export to TXT button. The exported file puts domain entries at the top and URL entries below, and an import of an old file can take up to 15 minutes.

The exact file format

Google accepts only a plain .txt file in UTF-8 or 7-bit ASCII, with one entry per line, and it rejects files that break the limits in this table, as of November 2026.

RuleLimit
File typePlain .txt file, UTF-8 or 7-bit ASCII
EntriesOne URL or domain entry per line
Whole domainPrefix with domain:, for example domain:example.com
SubpathsNot allowed, such as example.com/en/
Longest URL2,048 characters
Most lines100,000 lines, including blank and comment lines
Largest file2 MB
CommentsLines that start with # are ignored

For the background on the tool itself, see what the disavow tool is. The format above is the whole spec, so a file that follows it will upload without errors if every entry is a real URL or domain.

Tools and time needed

You need a plain-text editor and access to Search Console, and a backlink tool such as Semrush Backlink Audit helps on larger sites. No special software is needed to write the file itself, since it is only text.

A small list takes little time to write, while a large site with thousands of linking domains needs a longer review. The file itself costs nothing to make, and any tool cost depends on the plan you already hold, so check the vendor pricing page before you pay for anything.

Bing is not part of this work anymore. Bing removed its disavow links feature and its API in October 2023, after launching the tool in June 2012, because its systems can now tell natural links from unnatural ones.

How to measure results

Measure results by watching the Manual actions report, your rankings, and your traffic over several weeks, not by watching the Links report.

After a successful upload, Google says it can take a few weeks to fold your list in as Google recrawls the web and reprocesses the pages it sees. Semrush puts the wait at up to 6 weeks, so plan for weeks, not days.

Do not judge the upload by the Links report, because disavowed links stay listed there. Judge it by the Manual actions report, your rankings, and your traffic over the next few weeks, and give Google time to recrawl the linking pages first.

For what to expect, see does disavowing links help rankings.

You can undo a disavow at any time. Upload a new file without the entries you want to restore, or click Cancel Disavowals to remove the whole list, and allow a few weeks for that change to take effect as well.

Common mistakes

Most disavow mistakes come from treating the tool as routine cleanup instead of a last resort.

  • Disavowing every low-quality link you see. Google says most sites never need the tool, and a wrong disavow can harm your site's performance in search, so leave ordinary junk links alone.
  • Disavowing at URL level when the whole domain is spam. A domain-level entry covers every page on that domain, including new spam pages, while a URL-level entry can miss the same link on a second page.
  • Uploading a partial file and wiping your old list. A new upload replaces the old list for that property, so always upload the full master file, and remember that bad links can still hurt your SEO if you drop a needed entry by mistake.
  • Skipping the removal step. Google recommends removing as many spammy links as possible first, and disavowing without trying removal leaves the strongest cleanup move unused.
  • Building the file in a word processor. A .docx file is not a plain text file, so Google will not take it. Use a plain-text editor and save with a .txt name in UTF-8 or 7-bit ASCII.
  • Uploading to the wrong property. The tool does not support Domain properties, and a list applies only to its own property plus child properties, so pick the exact URL-prefix property for the site.
  • Expecting instant results. Google needs to recrawl the linking pages before the list takes effect, so a file uploaded today may not show any change for a few weeks.

Frequently Asked Questions

Can I disavow a whole folder or subpath, such as example.com/blog/?

No. Google says you cannot disavow an entire subpath, so example.com/blog/ will not work as one entry. Disavow the single pages by their full URLs, or disavow the whole domain with a domain: entry when every page on that domain is a problem.

How long does it take Google to process a disavow file?

Google says it can take a few weeks to fold a new list in as it recrawls the web and reprocesses the pages it sees. Semrush puts the wait at up to 6 weeks. Give the file at least that long before you judge whether it helped.

Does Bing have a disavow tool?

No. Bing removed its disavow links feature and its API in October 2023, after launching the tool in June 2012. Your disavow file is for Google only, and Bing says its systems now tell natural links from unnatural ones on their own.

No. Google says disavowed links will continue to show in the Links report, so the report will not shrink after you upload. The list only changes how Google judges those links, and you will not see that change in the report itself.

Can I undo a disavow?

Yes. Upload a new file that leaves out the entries you want to restore, and the new list replaces the old one for that property. To clear everything at once, click Cancel Disavowals in the tool, and allow a few weeks for the change to take effect.

Do I need a disavow file if I have no manual action?

Usually not. Google says to disavow only when you have many spammy, artificial, or low-quality links and those links have caused a manual action or are likely to cause one. If neither condition is met, leave the tool alone and spend the time on new links instead.

Sources

If you want the wider rules behind this cleanup, read our guide to Google's link spam policies.

BacklinkPrice Team
Written by
BacklinkPrice Team
Link building and backlink pricing research

The BacklinkPrice Team researches backlink prices, publisher sites and link building tools. We check prices and plans against each provider's own pages and date them, so you know how current the numbers are.

More from BacklinkPrice Team

Related guides