Title: Add your Plugin
Author: WordPress.org
Published: <strong>C'hwevrer 10, 2016</strong>
Last modified: Gouere 13, 2025

---

# Add your plugin

 Before you submit your plugin, we ask you to review our [Guidelines](https://developer.wordpress.org/plugins/wordpress-org/detailed-plugin-guidelines/)
and read the [Frequently Asked Questions](https://developer.wordpress.org/plugins/wordpress-org/plugin-developer-faq/).
A brief selection of common questions is available below the form.

Before you can upload a new plugin, [please log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fbre.wordpress.org%2Fplugins%2Fdevelopers%2Fadd%2F%3Foutput_format%3Dmd&locale=bre).

 Once submitted, your plugin will be manually reviewed for any common errors as 
well as ensuring it complies with [all the guidelines](https://developer.wordpress.org/plugins/wordpress-org/detailed-plugin-guidelines/).

## Frequently Asked Questions

### How long will the review process take?

 This is in the [Developer FAQ](https://developer.wordpress.org/plugins/wordpress-org/plugin-developer-faq/).
It takes anywhere between 1 and 10 days. We attempt to review all plugins within
5 business days of submission, but the process takes as long as it takes, depending
on the complexity of your plugin.

### How can I expedite my plugin review?

 Your plugin review cannot be prioritized over others, to help us approve your plugin
sooner, please ensure that you have read the [Security chapter](https://developer.wordpress.org/apis/security/)
of the Plugin Handbook.

Our three most common reasons for not approving a plugin are:

 * The plugin contains unescaped output: [Learn about Escaping Data](https://developer.wordpress.org/apis/security/escaping/)
 * The plugin accepts unsanitized data: [Learn about Sanitizing Data](https://developer.wordpress.org/apis/security/sanitizing/)
 * The plugin processes form data without a nonce: [Learn about Nonces](https://developer.wordpress.org/apis/security/nonces/)

If the code in your plugin falls into one of the above categories, **your plugin
will not be approved**. The Plugins Team will refer you back to these Handbook pages,
adding further delay to the review process.

### What will my plugin URL be?

Your plugin’s URL will be populated based on the value of `Plugin Name` in your 
main plugin file (the one with the plugin headers). If you set yours as `Plugin 
Name: Boaty McBoatface` then your URL will be `https://wordpress.org/plugins/boaty-
mcboatface` and your slug will be `boaty-mcboatface` for example. If there is an
existing plugin with your name, then you will be `boaty-mcboatface-2` and so on.
It behaves exactly like WordPress post names.

Once your plugin is approved, it _cannot_ be renamed.

### I made a mistake in my plugin name. Should I update it?

It depends on what you want to change. If you want to change the plugin **display
name** you can update that by updating your plugin files in this page. If what you
want to change is the **permalink / slug** of your plugin, you can do that ONCE 
before we begin with the review (if that’s available you’ll see a link to change
it on this page). If this is not possible, you will need to contact us at `plugins@wordpress.
org`, we can change it as long as the plugin has not yet been approved.

### Why can’t I submit a plugin with certain display names?

Certain plugin names are prohibited due to trademark abuse. Similarly, we prevent
their use in plugin slugs entirely for your protection.