apply_filters( 'the_content', string $content )

Filters the post content.

Description Description

Parameters Parameters


(string) Content of the current post.

Top ↑

Source Source

File: wp-includes/post-template.php

View on Trac

Top ↑

Changelog Changelog

Version Description
0.71 Introduced.

Top ↑

More Information More Information

This filter is used to filter the content of a post after it is retrieved from the database and before it is printed to the screen.

Top ↑

Usage Usage

When using this filter it’s important to check if you’re filtering the content in the main query with the conditionals is_main_query() and in_the_loop(). The main post query can be thought of as the primary post loop that displays the main content for a post, page or archive. Without these conditionals you could unintentionally be filtering the content for custom loops in sidebars, footers, or elsewhere.

add_filter( 'the_content', 'filter_the_content_in_the_main_loop' );

function filter_the_content_in_the_main_loop( $content ) {

    // Check if we're inside the main loop in a single post page.
    if ( is_single() && in_the_loop() && is_main_query() ) {
        return $content . "I'm filtering the content inside the main loop";

    return $content;


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note content
    Contributed by joncomputing

    You can choose whether $content will have Shortcodes processed before or after your the_content function has executed by setting the Priority in add_filter. The default (10) will process Shortcodes after you have returned $content at the end of your Filter function. A large figure, such as 99, will already have processed Shortcodes before your Filter function is passed $content.

You must log in before being able to contribute a note or feedback.