The robots.txt file in Yoast SEO

The robots.txt file tells a search engine where it is allowed to go on your website. In this article, we’ll explain how the robots.txt file works with Yoast SEO.


Warning: Undefined array key “className” in /home/staging-yoast/staging-platform.yoast.com/versions/704fed1651beec15b007273ac5c55f4f5b94454f/web/app/themes/yoast-theme/html_includes/blocks/landing-page/block-landing-page-list.php on line 21

You can improve the way search engines crawl your site with the Crawl optimization settings in Yoast SEO Premium! They allow you to remove unnecessary URLs, so search engines can crawl your site more efficiently!

Do you want to know more about what the robots.txt file is and what it does? Check out our Ultimate guide to robots.txt.

If the robots.txt file is not writable or your WordPress install has disabled file editing, the information here may not apply. Optionally, you can try edit the file at the server level.

The Yoast SEO default directives

By default, WordPress generates a robots.txt file with the following contents:

User-agent: *
Disallow: /wp-admin/
Allow: /wp-admin/admin-ajax.php

When you create a robots.txt with Yoast SEO, we’ll replace the WordPress default with the following:

# START YOAST BLOCK
# ---------------------------
User-agent: *
Disallow:

Sitemap: https://www.example.com/sitemap_index.xml
# ---------------------------
# END YOAST BLOCK

These directives allow all search engines to crawl your site. In addition, we add a link to your sitemap, so search engines, and (specifically Bing) can find it and crawl your site more efficiently.

How to create a robots.txt file in Yoast SEO

The easiest way to create or edit the robots.txt file is through Yoast SEO in the WordPress Dashboard. To do this, follow the steps below.

  1. Log in to your WordPress website.

    When you’re logged in, you will be in your ‘Dashboard’.

  2. Click on ‘Yoast SEO’ in the admin menu.


    Screenshot of the "Yoast SEO" menu item.

  3. Click on ‘Tools’.

    Screenshot of the "Tools" menu item.

  4. Click on ‘File Editor’.

    This menu will not appear if your WordPress install has disabled file editing. Please enable file editing or edit the file through FTP. If you are not sure how to use FTP, your host provider can help.A screenshot of the Tools settings screen in Yoast SEO, with the File editor settings the user needs to click on

  5. Click the Create robots.txt file button.

  6. View (or edit) the file generated by Yoast SEO.

    You will see the directions Yoast SEO adds to the file by default. You can also edit the file here.

Create or edit on your server

If the robots.txt file is not writable or your WordPress install has disabled file editing, creating or editing robots.txt with Yoast SEO may fail. In that case, you can edit at the server level. WordPress generates a virtual robots.txt file if the site root does not contain a physical file. To override the virtual file, please follow these steps to create a physical robots.txt file.

  1. Use your favorite text editor and create a text file.
  2. Save the empty file with the name robots.txt.
  3. Upload the file to your server. If you’re unsure where on your server to upload the file, please contact your webhost.

If WordPress was blocking access to the virtual file, you should be able to edit the physical file from our plugin. If not, you can always edit the robots.txt directly on your server using FTP or a server file manager.

Please contact your web host for assistance if you have trouble uploading or editing files on your server.

Did this article answer your question?

Thanks for your feedback!

Get free SEO tips!