Title: Toggle wpautop
Author: Jonathan Desrosiers
Published: <strong>February 25, 2013</strong>
Last modified: April 7, 2021

---

Search plugins

![](https://ps.w.org/toggle-wpautop/assets/banner-772x250.png?rev=2227939)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/toggle-wpautop/assets/icon.svg?rev=2227939)

# Toggle wpautop

 By [Jonathan Desrosiers](https://profiles.wordpress.org/desrosj/)

[Download](https://downloads.wordpress.org/plugin/toggle-wpautop.1.3.0.zip)

 * [Details](https://pcm.wordpress.org/plugins/toggle-wpautop/#description)
 * [Reviews](https://pcm.wordpress.org/plugins/toggle-wpautop/#reviews)
 *  [Installation](https://pcm.wordpress.org/plugins/toggle-wpautop/#installation)
 * [Development](https://pcm.wordpress.org/plugins/toggle-wpautop/#developers)

 [Support](https://wordpress.org/support/plugin/toggle-wpautop/)

## Description

**Note: This plugin does not support the block editor but should continue to work
without issue when using it with custom post types and the [Classic Editor Plugin](https://wordpress.org/plugins/classic-editor/).**

Before WordPress displays a post’s content, the content gets passed through multiple
filters to ensure that it safely appears how you enter it within the editor.

One of these filters is [wpautop](https://codex.wordpress.org/Function_Reference/wpautop),
which replaces double line breaks with `<p>` tags, and single line breaks with `
<br />` tags. However, this filter sometimes causes issues when you are inputting
a lot of HTML markup in the post editor.

This plugin displays a checkbox in the publish meta box of the post edit screen 
that disables the [wpautop](https://codex.wordpress.org/Function_Reference/wpautop)
filter for that post.

Also adds a ‘wpautop’, or ‘no-wpautop’ class to the post_class filter to help with
CSS styling.

## Screenshots

 * [[
 * The disable wpautop checkbox on post edit screens.
 * [[
 * Settings->Writing page with plugin settings.

## Installation

 1. Upload the plugin folder to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Proceed to the Settings->Writing and select which post types should have the option
    to disable the wpautop filter.

## FAQ

### Can I disable wpautop completely with this plugin?

Right now, no. wpautop is a great filter, and in most cases you should not need 
it disabled globally. However, if there is enough demand for this feature we can
add it.

### Can I set wpautop to default to “off” for new posts.

Yes.

## Reviews

![](https://secure.gravatar.com/avatar/bb5e35fe53c30ba9f7cc6ccbf2ffa29d5d3e900e6134ecadccda8c9612f9f23e?
s=60&d=retro&r=g)

### 󠀁[Top Tier Plugin](https://wordpress.org/support/topic/top-tier-plugin-8/)󠁿

 [ximbor](https://profiles.wordpress.org/ximbor/) August 10, 2021

Thank you for taking the time to create such an awesome plugin 🙂 finally those 
auto <p> tags are gone!

![](https://secure.gravatar.com/avatar/48c3b6b77082fceb5b12a06db65224ddf8c7e44ba1f65a94bccbbdda88de166f?
s=60&d=retro&r=g)

### 󠀁[Excelente Plugin](https://wordpress.org/support/topic/excelente-plugin-818/)󠁿

 [w3573r](https://profiles.wordpress.org/w3573r/) August 22, 2020

Excelente Plugin

![](https://secure.gravatar.com/avatar/7a02af1c7ff210c25f99e3689f1bc3958693b6751da625b17c58fd3d36898473?
s=60&d=retro&r=g)

### 󠀁[I doesn’t work with last wordpress version](https://wordpress.org/support/topic/i-doesnt-work-with-last-wordpress-version/)󠁿

 [juanmacampora](https://profiles.wordpress.org/juanmacampora/) July 19, 2020

Plugin need to be updated because it doesn’t work with last wordpress version. I
would like to use it but I am not able. Please, let me know how to overcome this
problem.

![](https://secure.gravatar.com/avatar/b443f2b4d2a8c061a93fdd52a7912c4673b4c8f1bd9c56039e8baf6db1c07254?
s=60&d=retro&r=g)

### 󠀁[Handy for to prevent HTML from being messed up](https://wordpress.org/support/topic/handy-for-to-prevent-html-from-being-messed-up/)󠁿

 [Dave Romsey (goto10)](https://profiles.wordpress.org/goto10/) December 20, 2018

wpautop adds p and br tags to HTML which can really mess things up. This plugin 
allows authors to disable the wpautop filter when necessary.

![](https://secure.gravatar.com/avatar/40d3265881e31111d0c40c83ba6b59bae901fe440737336e8a75c3d61c91dae2?
s=60&d=retro&r=g)

### 󠀁[Awesome. Should be builtin to WP.](https://wordpress.org/support/topic/awesome-should-be-builtin-to-wp/)󠁿

 [neotrope](https://profiles.wordpress.org/neotrope/) May 6, 2018

Solves inherent flaw in WP for editing custom web pages where WP puts in tags you
don’t want (try doing a definition list with double line breaks, and see how it 
breaks that with paragraph tags — this fixes stuff like that). Allows for clean 
migration of existing static page HTML to WP, without having to fix the nanny-fixes
WP tries to put in without asking and which are then hidden from you. Simply priceless
plugin for webdev. If you don’t know why this is so awesome, you likely don’t need
it. If you do know, you know why you must have it! And FYI: works with PHP 7.2 as
of May 2018.

![](https://secure.gravatar.com/avatar/7f91ad8dd1e610fc3db8f8283771d5c800a06ebca36f09d9726e5484b3c0ee70?
s=60&d=retro&r=g)

### 󠀁[Works as expected](https://wordpress.org/support/topic/works-as-expected-319/)󠁿

 [audunmb](https://profiles.wordpress.org/audunmb/) August 11, 2017

Had huge issues with carefully coded pages that WP “fixed” for me. Now I can avoid
it this, while keeping autoformatting where it’s handy.

 [ Read all 32 reviews ](https://wordpress.org/support/plugin/toggle-wpautop/reviews/)

## Contributors & Developers

“Toggle wpautop” is open source software. The following people have contributed 
to this plugin.

Contributors

 *   [ Jonathan Desrosiers ](https://profiles.wordpress.org/desrosj/)
 *   [ Linchpin ](https://profiles.wordpress.org/linchpin_agency/)
 *   [ Aaron Ware ](https://profiles.wordpress.org/aware/)

“Toggle wpautop” has been translated into 3 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/toggle-wpautop/contributors)
for their contributions.

[Translate “Toggle wpautop” into your language.](https://translate.wordpress.org/projects/wp-plugins/toggle-wpautop)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/toggle-wpautop/), check
out the [SVN repository](https://plugins.svn.wordpress.org/toggle-wpautop/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/toggle-wpautop/)
by [RSS](https://plugins.trac.wordpress.org/log/toggle-wpautop/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.3.0

 * Fixed minor sanitization of within the admin
 * Fixed minor WPCS and PHPCS notices
 * Updated plugin branding for .org
 * Updated readme to link to the Classic Editor Plugin
 * Updated deployment process to make releases easier

#### 1.2.5

 * Fixing an issue where http://translate.wordpress.org did not detect the stable
   version correctly.

#### 1.2.4

 * A few additional steps to make the plugin accessible to http://translate.wordpress.
   org.

#### 1.2.3

 * Move translations to http://translate.wordpress.org.

#### 1.2.2

 * Fixing PHP syntax error.

#### 1.2.1

 * Added ability for i18n using grunt-wp-i18n
 * Added english default .pot
 * Added minor security hardening so the class file would exit if called directly
 * Updated code formatting to be more inline with WordPress coding standards
 * Updated some method descriptions
 * Updated plugin description to be more… descriptive.

#### 1.2.0

 * Add a setting to disable wpautop automatically on new posts.
 * Add filter (lp_wpautop_show_private_pt) for enabling the plugin on private post
   types.

#### 1.1.2

 * Fixing bug that was preventing other settings on the writing page from saving.

#### 1.1.1

 * Fixing bug where users upgrading from 1.0 would not receive the defaults for 
   settings that were introduced in 1.1.

#### 1.1

 * Adding the ability to choose which post types have the option to disable the 
   wpautop filter on the Settings->Writing page.
 * When activating the plugin for the first time, all post types are set to have
   the ability to disable the wpautop filter. This can be changed on the Settings-
   >Writing page.
 * Adding an uninstall hook to remove all traces of the plugin.

#### 1.0

 * Hello world!

## Meta

 *  Version **1.3.0**
 *  Last updated **5 years ago**
 *  Active installations **10,000+**
 *  WordPress version ** 3.0 or higher **
 *  Tested up to **5.7.15**
 *  PHP version ** 5.6 or higher **
 *  Languages
 * [English (Australia)](https://en-au.wordpress.org/plugins/toggle-wpautop/), [English (Canada)](https://en-ca.wordpress.org/plugins/toggle-wpautop/),
   [English (New Zealand)](https://en-nz.wordpress.org/plugins/toggle-wpautop/),
   and [English (US)](https://wordpress.org/plugins/toggle-wpautop/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/toggle-wpautop)
 * Tags
 * [editor](https://pcm.wordpress.org/plugins/tags/editor/)[excerpt](https://pcm.wordpress.org/plugins/tags/excerpt/)
   [formatting](https://pcm.wordpress.org/plugins/tags/formatting/)[post content](https://pcm.wordpress.org/plugins/tags/post-content/)
   [wpautop](https://pcm.wordpress.org/plugins/tags/wpautop/)
 *  [Advanced View](https://pcm.wordpress.org/plugins/toggle-wpautop/advanced/)

## Ratings

 4.9 out of 5 stars.

 *  [  31 5-star reviews     ](https://wordpress.org/support/plugin/toggle-wpautop/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/toggle-wpautop/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/toggle-wpautop/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/toggle-wpautop/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/toggle-wpautop/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/toggle-wpautop/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/toggle-wpautop/reviews/)

## Contributors

 *   [ Jonathan Desrosiers ](https://profiles.wordpress.org/desrosj/)
 *   [ Linchpin ](https://profiles.wordpress.org/linchpin_agency/)
 *   [ Aaron Ware ](https://profiles.wordpress.org/aware/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/toggle-wpautop/)