Title: The WordPress file structure Published: 1 February 2024 Last modified: 31 July 2024 --- [Home](https://learn.wordpress.org)[Courses](https://learn.wordpress.org/courses/) [Beginner WordPress Developer](https://learn.wordpress.org/course/beginner-wordpress-developer/) The WordPress file structure [ Exit Course ](https://learn.wordpress.org/course/beginner-wordpress-developer/) 1. a. [ WordPress and web servers ](https://learn.wordpress.org/lesson/wordpress-and-web-servers/) [Preview](https://learn.wordpress.org/lesson/wordpress-and-web-servers/) b. [ The WordPress file structure ](https://learn.wordpress.org/lesson/the-wordpress-file-structure/) [Preview](https://learn.wordpress.org/lesson/the-wordpress-file-structure/) c. [ The WordPress database ](https://learn.wordpress.org/lesson/the-wordpress-database/) [Preview](https://learn.wordpress.org/lesson/the-wordpress-database/) d. [ Permalinks, rewriting urls on Apache and Nginx ](https://learn.wordpress.org/lesson/permalinks-rewriting-urls-on-apache-and-nginx/) [Preview](https://learn.wordpress.org/lesson/permalinks-rewriting-urls-on-apache-and-nginx/) e. [ Front-end page request ](https://learn.wordpress.org/lesson/front-end-page-request/) [Preview](https://learn.wordpress.org/lesson/front-end-page-request/) f. [ Admin page request ](https://learn.wordpress.org/lesson/admin-page-request/) [Preview](https://learn.wordpress.org/lesson/admin-page-request/) 2. 6 lessons 3. a. [ Local development environment ](https://learn.wordpress.org/lesson/local-development-environment/) [Preview](https://learn.wordpress.org/lesson/local-development-environment/) b. [ WordPress Installation ](https://learn.wordpress.org/lesson/wordpress-installation/) [Preview](https://learn.wordpress.org/lesson/wordpress-installation/) c. [ Code editor ](https://learn.wordpress.org/lesson/code-editor/) [Preview](https://learn.wordpress.org/lesson/code-editor/) d. [ Other useful development tools ](https://learn.wordpress.org/lesson/other-useful-development-tools/) [Preview](https://learn.wordpress.org/lesson/other-useful-development-tools/) 4. 4 lessons 5. a. [ HTML ](https://learn.wordpress.org/lesson/html/) [Preview](https://learn.wordpress.org/lesson/html/) b. [ CSS ](https://learn.wordpress.org/lesson/css/) [Preview](https://learn.wordpress.org/lesson/css/) c. [ JavaScript ](https://learn.wordpress.org/lesson/javascript/) [Preview](https://learn.wordpress.org/lesson/javascript/) d. [ PHP ](https://learn.wordpress.org/lesson/php/) [Preview](https://learn.wordpress.org/lesson/php/) e. [ MySQL ](https://learn.wordpress.org/lesson/mysql/) [Preview](https://learn.wordpress.org/lesson/mysql/) 6. 5 lessons 7. a. [ WordPress Hooks ](https://learn.wordpress.org/lesson/wordpress-hooks/) [Preview](https://learn.wordpress.org/lesson/wordpress-hooks/) b. [ Action Hooks ](https://learn.wordpress.org/lesson/action-hooks/) [Preview](https://learn.wordpress.org/lesson/action-hooks/) c. [ Filter Hooks ](https://learn.wordpress.org/lesson/filter-hooks/) [Preview](https://learn.wordpress.org/lesson/filter-hooks/) d. [ Working with hooks ](https://learn.wordpress.org/lesson/working-with-hooks/) [Preview](https://learn.wordpress.org/lesson/working-with-hooks/) 8. 4 lessons 9. a. [ Introduction to themes for developers ](https://learn.wordpress.org/lesson/what-is-a-theme/) [Preview](https://learn.wordpress.org/lesson/what-is-a-theme/) b. [ Theme structure ](https://learn.wordpress.org/lesson/theme-structure/) [Preview](https://learn.wordpress.org/lesson/theme-structure/) c. [ Main stylesheet ](https://learn.wordpress.org/lesson/main-stylesheet/) [Preview](https://learn.wordpress.org/lesson/main-stylesheet/) d. [ Templates ](https://learn.wordpress.org/lesson/templates-3/) [Preview](https://learn.wordpress.org/lesson/templates-3/) e. [ Global settings and styles ](https://learn.wordpress.org/lesson/global-settings-and-styles/) [Preview](https://learn.wordpress.org/lesson/global-settings-and-styles/) f. [ Create Block Theme plugin ](https://learn.wordpress.org/lesson/create-block-theme-plugin/) [Preview](https://learn.wordpress.org/lesson/create-block-theme-plugin/) 10. 6 lessons 11. a. [ What is a plugin? ](https://learn.wordpress.org/lesson/what-is-a-plugin/) [Preview](https://learn.wordpress.org/lesson/what-is-a-plugin/) b. [ Plugin requirements ](https://learn.wordpress.org/lesson/plugin-requirements/) [Preview](https://learn.wordpress.org/lesson/plugin-requirements/) c. [ Custom post types ](https://learn.wordpress.org/lesson/custom-post-types/) [Preview](https://learn.wordpress.org/lesson/custom-post-types/) d. [ Custom taxonomies ](https://learn.wordpress.org/lesson/custom-taxonomies/) [Preview](https://learn.wordpress.org/lesson/custom-taxonomies/) e. [ Custom post type data ](https://learn.wordpress.org/lesson/custom-post-type-data/) [Preview](https://learn.wordpress.org/lesson/custom-post-type-data/) f. [ Enqueuing CSS or JavaScript ](https://learn.wordpress.org/lesson/enqueuing-css-or-javascript/) [Preview](https://learn.wordpress.org/lesson/enqueuing-css-or-javascript/) 12. 6 lessons 13. a. [ Setting up your block development environment ](https://learn.wordpress.org/lesson/setting-up-your-block-development-environment/) [Preview](https://learn.wordpress.org/lesson/setting-up-your-block-development-environment/) b. [ Scaffolding a new block ](https://learn.wordpress.org/lesson/scaffolding-a-new-block/) [Preview](https://learn.wordpress.org/lesson/scaffolding-a-new-block/) c. [ Building your first block ](https://learn.wordpress.org/lesson/building-your-first-block/) [Preview](https://learn.wordpress.org/lesson/building-your-first-block/) d. [ Block functionality ](https://learn.wordpress.org/lesson/block-functionality/) [Preview](https://learn.wordpress.org/lesson/block-functionality/) e. [ Block attributes ](https://learn.wordpress.org/lesson/block-attributes-2/) [Preview](https://learn.wordpress.org/lesson/block-attributes-2/) f. [ Block supports and styles ](https://learn.wordpress.org/lesson/block-supports-and-styles/) [Preview](https://learn.wordpress.org/lesson/block-supports-and-styles/) g. [ Static vs dynamic blocks ](https://learn.wordpress.org/lesson/static-vs-dynamic-blocks/) [Preview](https://learn.wordpress.org/lesson/static-vs-dynamic-blocks/) 14. 7 lessons 15. a. [ The WordPress REST API ](https://learn.wordpress.org/lesson/the-wordpress-rest-api/) [Preview](https://learn.wordpress.org/lesson/the-wordpress-rest-api/) b. [ Using the WordPress REST API ](https://learn.wordpress.org/lesson/using-the-wordpress-rest-api/) [Preview](https://learn.wordpress.org/lesson/using-the-wordpress-rest-api/) c. [ Interacting with the WordPress REST API ](https://learn.wordpress.org/lesson/interacting-with-the-wordpress-rest-api/) [Preview](https://learn.wordpress.org/lesson/interacting-with-the-wordpress-rest-api/) d. [ Extending the WordPress REST API ](https://learn.wordpress.org/lesson/extending-the-wordpress-rest-api/) [Preview](https://learn.wordpress.org/lesson/extending-the-wordpress-rest-api/) 16. 4 lessons 17. a. [ Securely developing plugins and themes ](https://learn.wordpress.org/lesson/securely-developing-plugins-and-themes/) [Preview](https://learn.wordpress.org/lesson/securely-developing-plugins-and-themes/) b. [ Fixing common security vulnerabilities ](https://learn.wordpress.org/lesson/fixing-common-security-vulnerabilities/) [Preview](https://learn.wordpress.org/lesson/fixing-common-security-vulnerabilities/) c. [ Tools to detect security vulnerabilities ](https://learn.wordpress.org/lesson/tools-to-detect-security-vulnerabilities/) [Preview](https://learn.wordpress.org/lesson/tools-to-detect-security-vulnerabilities/) 18. 3 lessons 19. a. [ What is Internationalization? ](https://learn.wordpress.org/lesson/what-is-internationalization/) [Preview](https://learn.wordpress.org/lesson/what-is-internationalization/) b. [ The commonly used Internationalization functions ](https://learn.wordpress.org/lesson/the-commonly-used-internationalization-functions/) [Preview](https://learn.wordpress.org/lesson/the-commonly-used-internationalization-functions/) 20. 2 lessons 21. a. [ Setting up a WordPress multisite network ](https://learn.wordpress.org/lesson/setting-up-a-wordpress-multisite-network/) [Preview](https://learn.wordpress.org/lesson/setting-up-a-wordpress-multisite-network/) b. [ Managing a WordPress multisite network ](https://learn.wordpress.org/lesson/managing-a-wordpress-multisite-network/) [Preview](https://learn.wordpress.org/lesson/managing-a-wordpress-multisite-network/) c. [ Advanced multisite management ](https://learn.wordpress.org/lesson/advanced-multisite-management/) [Preview](https://learn.wordpress.org/lesson/advanced-multisite-management/) d. [ Developing for a multisite network ](https://learn.wordpress.org/lesson/developing-for-a-multisite-network/) [Preview](https://learn.wordpress.org/lesson/developing-for-a-multisite-network/) e. [ Building plugins and themes that support multisite ](https://learn.wordpress.org/lesson/building-plugins-and-themes-that-support-multisite/) [Preview](https://learn.wordpress.org/lesson/building-plugins-and-themes-that-support-multisite/) 22. 5 lessons 23. a. [ The built-in WordPress debugging options ](https://learn.wordpress.org/lesson/the-built-in-wordpress-debugging-options/) [Preview](https://learn.wordpress.org/lesson/the-built-in-wordpress-debugging-options/) b. [ Examining the state of your PHP code ](https://learn.wordpress.org/lesson/examining-the-state-of-your-php-code/) [Preview](https://learn.wordpress.org/lesson/examining-the-state-of-your-php-code/) c. [ Examining the state of your JavaScript code ](https://learn.wordpress.org/lesson/examining-the-state-of-your-javascript-code/) [Preview](https://learn.wordpress.org/lesson/examining-the-state-of-your-javascript-code/) d. [ Useful debugging plugins ](https://learn.wordpress.org/lesson/useful-debugging-plugins/) [Preview](https://learn.wordpress.org/lesson/useful-debugging-plugins/) 24. 4 lessons 25. a. [ Quiz time ](https://learn.wordpress.org/lesson/quiz-time/) 26. 1 lesson, 1 quiz 27. a. [ Time to test your skills ](https://learn.wordpress.org/lesson/time-to-test-your-skills/) 28. 1 lesson, 1 quiz 29. a. [ Test your knowledge ](https://learn.wordpress.org/lesson/test-your-knowledge/) 30. 1 lesson, 1 quiz ### A brief overview of how WordPress works # The WordPress file structure Welcome to this lesson on the WordPress file structure. Like most software applications, WordPress is made up of a collection of files organized into a specific structure. Because WordPress is open source, when you download the archive of the latest version of WordPress, you’re able to see and inspect all the files. Let’s explore the root directory of a WordPress installation in Visual Studio Code, a free and open-source code editor. ## The root directory The root directory of a WordPress site contains a series of files, as well as three directories. ## Static files First, let’s look at some of the static files: The `.htaccess` file is a special file that is used to configure the Apache web server for a WordPress installation. It is essentially an extension of the Apache Virtual Host configuration that we looked at earlier. Any valid Apache directives can be added to this file and will be applied for this WordPress installation. It’s worth noting that Nginx does not support the use of an .htaccess file-like configuration on a per WordPress level. Instead, the configuration is done in the main server block configuration file. This is one of the reasons that Nginx is considered to be faster than Apache, but also what makes it less configurable by the site owner. The `license.txt` file contains the license information for WordPress. WordPress is licensed under the open-source GNU General Public License, version 2. This license allows anyone to use, modify, and redistribute WordPress. The `readme.html` file contains information about WordPress, including sections on installing and updating WordPress, system requirements, and links to various online resources. As an HTML file, it’s best viewed in a web browser. ## PHP files that control a WordPress request Now let’s move on to the PHP files that control a typical WordPress request As you learned in the Web Servers lesson, the `index.php` file is the directory index file, and it is executed when a user visits the root URL of this WordPress site. When the code in `index.php` is executed, it includes the code in the `wp-blog-header. php` file. As you can see `wp-blog-header.php` includes `wp-load.php`, which in turn includes the `wp-config.php` file. The `wp-config.php` file is the main configuration file for a WordPress site. It contains all the configuration options that are required to run WordPress, like database connection information, security keys, and any custom configuration options that you may want to add. `wp-config.php` then includes the `wp-settings.php` file, which sets up all the WordPress core functionality. ## Additional PHP files in the root directory There are some additional PHP files in the root directory that perform specific functions outside of regular WordPress requests. These files are usually accessed directly by either a user or some other function and are not included in the normal WordPress request flow. `wp-activate.php` is used to confirm the activation key that is sent in an email after a user signs up for a new site. Typically, this would be used if you were setting up a WordPress install yourself or managing a WordPress multisite network. `wp-comments-post.php` is used to process any comments that are submitted on a WordPress site. `wp-cron.php` is used to run any scheduled tasks that are set up on a WordPress site. This file is executed every time a WordPress page is requested, and it checks to see if there are any scheduled tasks that need to be run. If there are, it runs them. `wp-links-opml.php` is used to generate an XML list of links. This was used by a Link Manager feature that was removed in WordPress 3.5. However, it is possible to enable this functionality using [the Link Manager plugin](https://wordpress.org/plugins/link-manager/), and so this file is still included for backwards compatibility. `wp-login.php` is used to display the login form for a WordPress site. It also processes any login requests that are submitted. `wp-mail.php` is used by the Post via email feature of WordPress. This feature allows you to publish posts on your WordPress site by sending an email to a specific email address. If enabled, this file is executed every time an email is received to create a new post. `wp-signup.php` is used to display the signup form for a new site on a WordPress multisite network. `wp-trackback.php` is used to process any trackback requests that are sent to a WordPress site. Trackbacks are a way for one website to notify another website that it has linked to it, usually in a post content or comment. `xmlrpc.php` is used to process any XML-RPC requests that are sent to a WordPress site. XML-RPC is a remote procedure call protocol that allows software to make requests to a WordPress site. This is used by the WordPress mobile apps, but you can disable this functionality if you don’t use those apps to manage your site. ## Root directories Alongside these files, the root directory of a WordPress installation also contains three directories: `wp-admin` contains all the files that power the WordPress admin interface. Whenever you’re interacting with the WordPress admin, you’re using files from this directory. `wp-content` contains any files that can be added to a default WordPress site. This includes any plugins, themes, and uploaded files. Any directories that plugins need to create to store additional files are also created in this directory. `wp-includes` contains the bulk of the core WordPress files. This includes all the PHP files that make up the WordPress core, as well as any JavaScript and CSS files that are required to run WordPress. Common functionality like the database API, HTTP API, and plugin API are all included in this directory and are used by both the WordPress admin and any front-end requests. This is a preview lesson Register or sign in to take this lesson. [ Take course ](https://learn.wordpress.org/course/beginner-wordpress-developer/) [ Sign in ](https://login.wordpress.org/?redirect_to=https%3A%2F%2Flearn.wordpress.org%2Flesson%2Fthe-wordpress-file-structure%2F&locale=en_US) ## Suggestions Found a typo, grammar error or outdated screenshot? [Contact us](https://learn.wordpress.org/report-content-feedback/).