Explainers · Explainer
What Is a WordPress Plugin? A Plain Explanation

Short answer
A WordPress plugin is a package of code you install on a WordPress site to add a feature or change how the site works, without editing WordPress itself. Themes control how a site looks, while plugins control what it does. The WordPress.org directory holds over 50,000 free plugins, and most are released under the GPL license.
Key takeaways
- A plugin is a package of code that adds features to a WordPress site without editing WordPress itself.
- The WordPress.org plugin directory holds over 50,000 free plugins.
- Themes control how a site looks, while plugins control what it does.
- A valid plugin needs only one PHP file with a header comment, and plugins live in wp-content/plugins.
- Check the last updated date and tested-up-to version before installing any plugin.
What is a WordPress plugin?
A WordPress plugin is a package of code you install on a WordPress site to add a feature or change how the site works, without editing WordPress itself.
Learn WordPress defines a plugin as a package of code that can be installed on a WordPress website to add new features or functionality.
Plugins are how WordPress stays small at its core and large in what it can do. The lesson plan on choosing plugins notes that the core of WordPress is designed to be lean and lightweight, to maximize flexibility and minimize code bloat, and plugins let each user tailor the site to their needs.
The scale is easy to see. Learn WordPress states that the WordPress plugin directory contains over fifty thousand plugins, and W3Techs reported on 21 November 2026 that WordPress is used by 38.5% of all websites.
What can a plugin do?
A plugin can add almost any feature WordPress lacks, from a contact form or an online store to spam filtering or a membership system.
Learn WordPress notes that plugins can turn a WordPress site into an online store, a social network, a learning management system, and much more.
The lesson plan on choosing plugins lists common types: SEO, backup, security, sliders and galleries, forums and social networks, API plugins for services such as Twitter and Instagram, and tutorials. That list is a sample, not a limit, since plugins cover far more jobs than those seven.
Two plugins ship with WordPress by default. Learn WordPress names Akismet, an anti-spam plugin, and Hello Dolly, an example of a really simple plugin.
Akismet checks comments against the Akismet web service to see if they look like spam, and lets you review the spam it catches under the Comments screen. Hello Dolly shows a lyric from “Hello, Dolly” in the upper right of the admin screen when it is activated.
WooCommerce shows how far a plugin can go. W3Techs reported on 21 November 2026 that WooCommerce is used by 19.7% of all websites that use WordPress, which makes a single plugin the shop system for a large share of the web.
How is a plugin different from a theme?
A theme controls how your site looks, while a plugin controls what your site does, and keeping the two apart protects your features when you change the design.
Learn WordPress puts it plainly: themes are used to control the look and feel of a WordPress site, while plugins are used to add to or extend its functionality.
The lesson plan on choosing plugins gives the rule in full: a theme controls the presentation of content, whereas a plugin is used to control the behavior and features of your WordPress site.
That split matters when you change themes. The lesson plan warns that a theme should not add critical functionality, because users lose that functionality when they change themes. A portfolio built into a theme vanishes with the theme, while the same portfolio in a plugin survives the switch.
Our guide on theme vs plugin in WordPress walks through the border between the two, with examples of features that belong on each side.
| Plugin | Theme | |
|---|---|---|
| Controls | What the site does | How the site looks |
| Examples | Contact forms, stores, spam filters, backups | Layout, colors, fonts, templates |
| When you switch | Stays active and keeps working | Changes the whole design |
| Risk if misused | Slows the site if poorly built | Loses features built into it |
What is inside a plugin?
A plugin is at least one PHP file with a special comment block at the top, and most plugins add more files, folders, and assets around it.
Most plugins in the directory are composed of many files, but Learn WordPress notes that a valid plugin needs only one main PHP file with a specifically formatted comment block, also known as a DocBlock, at the top.
Hello Dolly is the classic single-file example. Learn WordPress notes that all its functionality sits in one PHP file called hello.php, and it was one of the first plugins for WordPress.
Akismet shows the other end of the scale. Learn WordPress explains that its akismet folder holds all the files, and the main file akismet.php handles loading the other files.
The comment block at the top tells WordPress that the file is a plugin. The Plugin Handbook states that a header comment must contain the Plugin Name at a minimum.
The same page lists the other fields a header can carry: Plugin URI, a description of fewer than 140 characters, Version, the lowest WordPress version it needs, the lowest PHP version it needs, Author, License, Text Domain, and a list of plugins it depends on.
Where do plugins live on your site?
Plugins live in the wp-content/plugins folder on your server, with each plugin in its own folder or as a single file.
Learn WordPress states that when installed, plugins exist inside the wp-content/plugins directory of a WordPress site.
A single-file plugin sits there as one PHP file, while a multi-file plugin sits there as a folder named after the plugin. WordPress scans that folder when it builds the plugin list in the dashboard.
That folder is also where trouble shows up. If a plugin breaks the dashboard, you can rename its folder through your host's file manager or FTP, which deactivates it without any dashboard access.
Our guide on how to fix a plugin conflict shows the step-by-step method for finding which plugin is at fault when the site breaks.
How do you install a plugin?
Go to Plugins, then Add New, search the directory, click Install, then click Activate, and the plugin starts working.
The directory is the safest source. Learn WordPress calls the WordPress Plugin Directory the best and safest place to get free plugins, since every plugin there has been reviewed and approved under the plugin guidelines.
Installing from the directory takes 4 steps: go to Plugins, then Add New, search for the plugin or browse a category, click Install, then click Activate. An installed plugin does nothing until you activate it.
A plugin bought outside the directory arrives as a zip file. The same lesson gives the route: go to Plugins, then Add New, click Upload Plugin, choose the file, click Install Now, then click Activate.
You can browse the WordPress Plugin Directory from any browser, or search it from inside your own dashboard on the Plugins, then Add New screen.
Back up first. The lesson warns that it is a best practice to make a full backup of your website before installing a new plugin, as some plugins could cause your site to become inoperable.
Check the listing page for the last updated date and the tested-up-to version before you click Install.
How do you pick a safe plugin?
Check the last updated date, the tested-up-to version, the star rating, the download count, and the support forum before you install anything.
Learn WordPress lists the standard information to review on each plugin page: star rating, last updated, number of downloads, compatibility rating, author information, and support forums.
The last updated date matters most. A plugin with no update for a year or more may not work with the current WordPress version, and it may carry unfixed security issues.
The tested-up-to version tells you which WordPress version the author last checked the plugin against. W3Techs reported on 21 November 2026 that version 7 runs on 70.4% of WordPress sites, so a plugin tested only up to version 5 is a warning sign.
Check the support forum too. A plugin with recent, answered questions has an author who is still paying attention, while a forum full of unanswered reports suggests the plugin is on its own.
Our guide on how to find abandoned WordPress plugins shows how to spot a plugin the author has stopped updating.
Our guide on free vs premium WordPress plugins explains when a paid version is worth the money and when the free version is enough.
What do plugins cost?
Most plugins are free, with paid versions that add features, and the free ones in the directory use the GPL license, the same license WordPress itself uses.
Most plugins in the WordPress.org directory cost nothing to install and use. Paid plugins, and paid versions of free plugins, usually add features, remove limits, or add support, and they are sold by the author or a shop.
The Plugin Handbook notes that most WordPress plugins are released under the GPL, which is the same license that WordPress itself uses, and it advises authors to state the license clearly.
That license matters to you as a site owner. A GPL plugin can be studied, changed, and shared under the terms of the license, which is why so many free plugins exist and why many are kept up by a community.
What mistakes should you avoid with plugins?
Do not install plugins you do not need, do not skip the backup before installing one, and do not keep plugins you no longer use.
The first mistake is piling up plugins. Every active plugin adds code that runs on your site, so install only the ones that do a job you need, and remove the rest.
The second mistake is skipping the backup. Learn WordPress warns that a new plugin can make a site inoperable, so take a full backup of the files and database before you install one.
The third mistake is leaving unused plugins installed. A deactivated plugin still sits in your wp-content/plugins folder, and an old one can carry a security flaw even when it is switched off, so delete it instead.
Our guide on how many plugins is too many for WordPress looks at when the count itself becomes a problem and when it does not.
Frequently asked questions
Can I turn a plugin off without breaking my site?
Yes, in the sense that you can switch one off and the site keeps working, though the feature it added will stop. Deactivating a plugin is safe to try, and reactivating it brings the feature back. If a plugin breaks the dashboard, you can also rename its folder in wp-content/plugins through your host's file manager to switch it off.
Is it safe to install many plugins?
Yes, but only if each one is checked on its own. A plugin's safety depends on its author, its last update date, and its code, not on how many plugins you already run. Review the listing page for the last updated date, the tested-up-to version, and the support forum before installing, just as you would for the first plugin.
Are free plugins as good as paid ones?
Yes. Paid versions usually add features, remove limits, or add support, while the free version keeps the core job working. The WordPress.org directory lists only free plugins, and many of the most used plugins on the web, including WooCommerce and Akismet, run a free version alongside a paid one.
How long should a plugin description be?
The short description in the plugin header must stay under 140 characters, and the readme file's short description should stay under 150 characters, according to the Plugin Handbook. Those limits keep the listing tidy in the directory and in the dashboard, so keep the description short and say what the plugin does in one line.
What should I do if a plugin I use is abandoned?
First, check the plugin's page on WordPress.org for a closure notice or a long gap since its last update. Then look for a plugin that does the same job and is actively updated, install it on a staging copy of your site, and check that your content and settings carry over before you switch the live site.
Sources
- What is a plugin? Learn WordPress
- Choosing And Installing Plugins Learn WordPress
- Header Requirements WordPress Developer Resources
- Including a Software License WordPress Developer Resources
- Usage Statistics and Market Share of WordPress, November 2026 W3Techs
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


