WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

disable_captions

apply_filters( ‘disable_captions’, bool $bool )

In this article

Back to top

Filters whether to disable captions.

Description

Prevents image captions from being appended to image HTML when inserted into the editor.

Parameters

$boolbool
Whether to disable appending captions. Returning true from the filter will disable captions. Default empty string.

Source

if ( empty( $caption ) || apply_filters( 'disable_captions', '' ) ) {

View all references View on Trac View on GitHub

Used byDescription
wp_tinymce_inline_scripts()wp-includes/script-loader.php

Adds inline scripts required for the TinyMCE in the block editor.

media_upload_type_url_form()wp-admin/includes/media.php

Outputs the legacy media upload form for external media.

wp_media_insert_url_form()wp-admin/includes/media.php

Creates the form for external url.

image_add_caption()wp-admin/includes/media.php

Adds image shortcode with caption to editor.

_WP_Editors::editor_settings()wp-includes/class-wp-editor.php
wp_print_media_templates()wp-includes/media-template.php

Prints the templates used in the media manager.

Show 1 moreShow less

Changelog

VersionDescription
2.6.0Introduced.

User Contributed Notes

  1. Skip to note 2 content
    Rami Yushuvaev
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Disable captions from all the images:

    add_filter( 'disable_captions', '__return_true' );

    Disable captions from images in specific pages:

    function generatewp_caption_disabler() {
	if ( is_home() ) {
		return true;
	} else {
		return false;
	}
}
add_filter( 'disable_captions', 'generatewp_caption_disabler' );

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