WordPress.org

apply_filters( 'disable_captions', bool $bool )

Filters whether to disable captions.

Contents

Description
Related
- Used By
User Contributed Notes

Description Description

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

Parameters Parameters

$bool: (bool) Whether to disable appending captions. Returning true to the filter will disable captions. Default empty string.

Source Source

File: wp-admin/includes/media.php

Changelog Changelog

Changelog
Version	Description
2.6.0	Introduced.

Used By Used By

Used By
Used By	Description
wp-includes/script-loader.php: wp_tinymce_inline_scripts()	Adds inline scripts required for the TinyMCE in the block editor.
wp-admin/includes/media.php: media_upload_type_url_form()	Outputs the legacy media upload form for external media.
wp-admin/includes/media.php: wp_media_insert_url_form()	Creates the form for external url
wp-admin/includes/media.php: image_add_caption()	Adds image shortcode with caption to editor
wp-includes/media.php: wp_enqueue_media()	Enqueues all scripts, styles, settings, and templates necessary to use all media JS APIs.
wp-includes/class-wp-editor.php: _WP_Editors::editor_settings()
wp-includes/media-template.php: wp_print_media_templates()	Prints the templates used in the media manager.

Show 2 more used by Hide more used by

User Contributed Notes User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note

Contributed by Rami Yushuvaev — 1 year ago
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' );
```
Log in to add feedback

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