WordPress filter hook · part of WordPress core

widget_text

A WordPress core filter that 112 plugins also fire themselves, running on 15.6M+ sites between them.

“This filter is documented in wp-includes/widgets/class-wp-widget-text.php”

How to use widget_text

It's a filter: your callback receives the value, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'widget_text', function( $instance ) {
	// Change $instance here.
	return $instance;
}, 10, 1 );

Argument names come from Connect SendGrid for Emails's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

This hook is fired by WordPress core too. Official reference on developer.wordpress.org →

112 plugins that fire widget_text

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. Elementor Agent Ready Website Builder icon Elementor Agent Ready Website Builder10+ million installs apply_filters( 'widget_text', $content, $this->get_settings() ) includes/base/widget-base.php:452
  2. Jetpack icon Jetpack3+ million installs apply_filters( 'widget_text', $instance['caption'] ) modules/widgets/image-widget.php:114
  3. Breadcrumb NavXT icon Breadcrumb NavXT700,000+ installs apply_filters( 'widget_text', $instance['pretext'], $instance ) class.bcn_widget.php:38
  4. SiteOrigin Widgets Bundle icon SiteOrigin Widgets Bundle400,000+ installs apply_filters( 'widget_text', $instance['text'], $instance, $this ) widgets/editor/editor.php:97
  5. Members icon Members300,000+ installs apply_filters( 'widget_text', $instance['logged_in_text'] ) inc/class-widget-login.php:110
  6. Newsletter icon Newsletter200,000+ installs apply_filters( 'widget_text', $instance['text'], $instance ) widget/standard.php:54
  7. Black Studio TinyMCE Widget icon Black Studio TinyMCE Widget200,000+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance, $this ) includes/class-widget.php:55
  8. Image Widget icon Image Widget100,000+ installs apply_filters( 'widget_text', $instance['description'], $args, $instance ) image-widget.php:128
  9. ProfilePress icon ProfilePress100,000+ installs apply_filters( 'widget_text', empty($instance['text']) ? "" : $instance['text'], $instance ) deprecated/wp-user-avatar/includes/class-wp-user-avatar-widget.php:25
  10. One User Avatar icon One User Avatar100,000+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) includes/class-wp-user-avatar-widget.php:57
  11. Strong Testimonials icon Strong Testimonials80,000+ installs apply_filters( 'widget_text', $widget_text, $data, $this ) includes/class-strong-testimonials-view-widget.php:39
  12. AMP for WP icon AMP for WP70,000+ installs apply_filters( 'widget_text', $instance['content'], $simulated_text_widget_instance, $this ) templates/amp-code-widget.php:47
  13. Media Library Assistant icon Media Library Assistant70,000+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) includes/class-mla-objects.php:356
  14. WP Maps icon WP Maps60,000+ installs apply_filters( 'widget_text', empty( $instance['map_title'] ) ? '' : $instance['map_title'], $instance ) classes/wpgmp-map-widget.php:51
  15. Gum Addon for Elementor icon Gum Addon for Elementor50,000+ installs apply_filters( 'widget_text', $content, $element->get_settings() ) widgets/accordion.php:697
  16. Social Media Widget icon Social Media Widget30,000+ installs apply_filters( 'widget_text', $instance['text'], $instance ) social-widget.php:364
  17. Scripts n Styles icon Scripts n Styles30,000+ installs apply_filters( 'widget_text', empty( $instance[ 'text' ] ) ? '' : $instance[ 'text' ], $instance ) scripts-n-styles.php:493
  18. User Frontend icon User Frontend20,000+ installs apply_filters( 'widget_text', $instance['uname_label'] ) includes/Widgets/Login_Widget.php:218
  19. WP YouTube Lyte icon WP YouTube Lyte20,000+ installs apply_filters( 'widget_text', $instance['WYLtext'], $instance ) widget.php:14
  20. Apollo13 Framework Extensions icon Apollo13 Framework Extensions20,000+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) widgets/text.php:164
  21. FV Flowplayer Video Player icon FV Flowplayer Video Player10,000+ installs apply_filters( 'widget_text', $widget_text, $instance, $this ) models/widget.php:48
  22. Shortcode Widget icon Shortcode Widget10,000+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance, $this ) includes/class-shortcode-widget.php:64
  23. Simple Image Widget icon Simple Image Widget10,000+ installs apply_filters( 'widget_text', $instance['text_raw'], $instance, $this->id_base ) includes/class-simple-image-widget.php:87
  24. WP Photo Album Plus icon WP Photo Album Plus10,000+ installs apply_filters( 'widget_text', $text ) wppa-gp-widget.php:54
  25. Restaurant Menu icon Restaurant Menu7,000+ installs apply_filters( 'widget_text', Glf_Utils::glf_mor_get_shortcode( isset( $instance[ "ruid" ] ) ? $instance[ "ruid" ] : "", 'ordering', isset( $instance[ 'use_custom_css' ] ) ? $instance[ 'use_custom_css' ] : 0, isset( $instance[ 'class' ] ) ? $instance[ 'class' ] : '' ), $instance, $this ) includes/modules/widgets/class-glf-mor-widget.php:32
  26. Contact Form 7 Widget icon Contact Form 7 Widget2,000+ installs apply_filters( 'widget_text', $widget_text ) contact-form-7-widget.php:57
  27. FV Player 8 icon FV Player 81,000+ installs apply_filters( 'widget_text', $widget_text, $instance, $this ) models/widget.php:52
  28. YAHMAN Add-ons icon YAHMAN Add-ons1,000+ installs apply_filters( 'widget_text', '<ins class="adsbygoogle" style="display:block;" data-ad-format="autorelaxed" data-ad-client="'.$data['client'].'" data-ad-slot="'.$data['slot'].'"'.$data['matched'] .'></ins> <script> (adsbygoogle = window.adsbygoogle || []).push({}); </script>' ) inc/widget/widget-google_ad-autorelaxed.php:114
  29. Widget Contact Form 7 icon Widget Contact Form 71,000+ installs apply_filters( 'widget_text', '[contact-form-7 id="' . $widget_text . '"]' ) cf7-widget.php:34
  30. PilotPress icon PilotPress900+ installs apply_filters( 'widget_text', do_shortcode($textarea) ) pilotpress.php:4996
  31. Genesis Club Lite icon Genesis Club Lite900+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance, $this ) classes/class-widget.php:443
  32. Connect SendGrid for Emails icon Connect SendGrid for Emails800+ installs apply_filters( 'widget_text', $instance['text'] ) lib/class-sendgrid-nlvx-widget.php:138
  33. Wild Apricot Login icon Wild Apricot Login800+ installs apply_filters( 'widget_text', $instance[self::LOGIN_LABEL_ID], $instance ) Modules/Authorization/WaLogin/Widget.php:50
  34. User Avatar icon User Avatar800+ installs apply_filters( 'widget_text', empty($instance['text']) ? "" : $instance['text'], $instance ) includes/class-wp-user-avatar-widget.php:39
  35. IntelliWidget Per Page Custom Menus and Dynamic Content icon IntelliWidget Per Page Custom Menus and Dynamic Content600+ installs apply_filters( 'widget_text', $custom_text, $instance ) includes/classes/Widget.php:75
  36. Section Widget icon Section Widget500+ installs apply_filters( 'widget_text', do_shortcode($instance['body']) ) section-widget.php:87
  37. Linkable Title Html and Php Widget icon Linkable Title Html and Php Widget500+ installs apply_filters( 'widget_text', $instance['text'], $instance ) linkable-title-html-and-php-widget.php:42
  38. Parallel Extensions icon Parallel Extensions300+ installs apply_filters( 'widget_text', $instance['text'] ) widgets/service_widget.php:39
  39. Custom Field Widget icon Custom Field Widget200+ installs apply_filters( 'widget_text', $options[$number]['text'] ) custom-field-widget.php:49
  40. Simple Secure Contact Form icon Simple Secure Contact Form200+ installs apply_filters( 'widget_text', empty( $instance['widget_description'] ) ? '' : $instance['widget_description'], $instance ) simple-secure-contact-form.php:93
  41. Advanced Custom Field Widget icon Advanced Custom Field Widget100+ installs apply_filters( 'widget_text', $options[$number]['data1keysep'] ) adv-custom-field-widget.php:237
  42. Serenity Extensions icon Serenity Extensions100+ installs apply_filters( 'widget_text', $instance['link_text'] ) widgets/service_widget.php:43
  43. Service Boxes Widgets Text Icon icon Service Boxes Widgets Text Icon100+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) service-boxs-widgets-text-icon.php:200
  44. Category Country Aware WordPress icon Category Country Aware WordPress100+ installs apply_filters( 'widget_text', $content ) cca_textwidget.php:746
  45. Call to Action Widget icon Call to Action Widget100+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) cta-widget.php:25
  46. Allow Javascript in Text Widgets icon Allow Javascript in Text Widgets100+ installs apply_filters( 'widget_text', $instance['text'], $instance ) allow-javascript-in-text-widgets.php:28
  47. PG Context Sidebar icon PG Context Sidebar90+ installs apply_filters( 'widget_text', $content ) pg-context-sidebar.php:488
  48. WP Shaper Image and Text icon WP Shaper Image and Text90+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) wpshaper-image-and-text.php:43
  49. wp scroll posts icon wp scroll posts90+ installs apply_filters( 'widget_text', $instance['text'] ) wp-scroll-posts.php:326
  50. Single Image Widget icon Single Image Widget80+ installs apply_filters( 'widget_text', $instance['text_raw'], $instance, $this->id_base ) includes/class-single-image-widget.php:87
  51. LandTech Extras for Elementor icon LandTech Extras for Elementor70+ installs apply_filters( 'widget_text', $content, $element->get_settings() ) extensions/tooltip.php:428
  52. Unicon extensions icon Unicon extensions60+ installs apply_filters( 'widget_text', $widget_text, $instance, $this ) inc/widget-contact.php:34
  53. PhotoShelter Gallery Widget icon PhotoShelter Gallery Widget50+ installs apply_filters( 'widget_text', $instance['id'] ) photoshelter.php:35
  54. Avante Theme Extensions icon Avante Theme Extensions50+ installs apply_filters( 'widget_text', $instance['link_text'] ) widgets/service_widget.php:43
  55. xili Post in Post icon xili Post in Post50+ installs apply_filters( 'widget_text', $instance['text'], $instance ) class-xili-post-in-post-widget.php:69
  56. My Recent YouTube Widget icon My Recent YouTube Widget40+ installs apply_filters( 'widget_text', $options[$number]['username'] ) MyRecentYT.php:82
  57. Widget Text Icon icon Widget Text Icon40+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) widgets-text-icon.php:145
  58. DG Accordian icon DG Accordian30+ installs apply_filters( 'widget_text', $widget_text, $instance, $this ) includes/class-wp-widget-text.php:62
  59. Locus icon Locus30+ installs apply_filters( 'widget_text', $instance['text'], $instance ) control/widgets.php:17
  60. SB Uploader icon SB Uploader30+ installs apply_filters( 'widget_text', $instance['backup_text'] ) sb_uploader.php:2055
  61. Image In The Widget icon Image In The Widget30+ installs apply_filters( 'widget_text', $instance['description'], $args, $instance ) image-widget.php:89
  62. WP Is Mobile Text Widget icon WP Is Mobile Text Widget20+ installs apply_filters( 'widget_text', $instance['text'], $instance, $this ) inc/class-wp-is-mobile-text-widget.php:79
  63. Dashboard Widget icon Dashboard Widget20+ installs apply_filters( 'widget_text', $instance['content'], $simulated_text_widget_instance, $this ) _inc/widget/html.php:108
  64. DynamicKit for Elementor icon DynamicKit for Elementor20+ installs apply_filters( 'widget_text', $content, $widget->get_settings() ) includes/extensions/tooltips.php:583
  65. Latest Posts With Thumbnails and Ads icon Latest Posts With Thumbnails and Ads20+ installs apply_filters( 'widget_text', empty( $instance['adstext'] ) ? '' : $instance['adstext'], $instance ) latest-posts.php:169
  66. Pro Text Widget icon Pro Text Widget20+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) pro-text-widget.php:21
  67. Ajax Contact Forms (ACF SP) icon Ajax Contact Forms (ACF SP)10+ installs apply_filters( 'widget_text', $instance['acfw30_form_id'] ) acfw30-widgets.php:28
  68. Linked Pages icon Linked Pages10+ installs apply_filters( 'widget_text', $options[$number]['title'] ) linkedpages.php:595
  69. Coin of the Realm icon Coin of the Realm10+ installs apply_filters( 'widget_text', $instance['no_purchases_text'] ) coin_of_the_realm.php:502
  70. Christian Science Bible Lesson Subjects icon Christian Science Bible Lesson Subjects10+ installs apply_filters( 'widget_text', empty( $instance['weeks_to_display'] ) ? __( '3', 'christian-science-bible-lesson-subjects' ) : $instance['weeks_to_display'], $instance ) cs-subject-of-the-week.php:311
  71. Dolomon icon Dolomon10+ installs apply_filters( 'widget_text', $cat['name'] ) widget.php:51
  72. WPshed Theme Extras icon WPshed Theme Extras10+ installs apply_filters( 'widget_text', get_the_content( esc_html( $more_text ) ) ) inc/functions-shortcodes.php:172
  73. Associator icon Associator10+ installs apply_filters( 'widget_text', $shortcode ) classes/class-associator.php:100
  74. Embed Grooveshark icon Embed Grooveshark10+ installs apply_filters( 'widget_text', $instance['alternative'], $instance ) includes/GroovesharkPlaylistWidget.class.php:43
  75. Aazeen extension icon Aazeen extension10+ installs apply_filters( 'widget_text', $widget_text, $instance, $this ) inc/widget-callout.php:54
  76. Scriblio icon Scriblio10+ installs apply_filters( 'widget_text', $instance['context-top'] ) plugin/widgets.php:242
  77. Extensible Widgets icon Extensible Widgets10+ installs apply_filters( 'widget_text', $this->settings['content'] ) includes/wpew/widgets/Content.php:74
  78. Social Media Control Centre icon Social Media Control Centre10+ installs apply_filters( 'widget_text', $instance['text'], $instance ) widget/standard.php:127
  79. MO Widgets icon MO Widgets10+ installs apply_filters( 'widget_text', $instance['body'] ) MO-widgets-cn.php:129
  80. List of User’s Posts Widget icon List of User’s Posts Widget10+ installs apply_filters( 'widget_text', $widget_text, $instance, $this ) louposts.php:78
  81. Color Widgets icon Color Widgets10+ installs apply_filters( 'widget_text', $instance['text'] ) colorwidgets.php:25
  82. Amber Alert Nederland icon Amber Alert Nederland10+ installs apply_filters( 'widget_text', $instance['text'], $instance ) includes/client/plugins/automatisch/footer.php:45
  83. Web2Store from Adelya icon Web2Store from Adelya10+ installs apply_filters( 'widget_text', $instance['text'] ) newsletterWidget.php:19
  84. Hackadelic Discreet Text Widget icon Hackadelic Discreet Text Widget10+ installs apply_filters( 'widget_text', $instance['text'] ) hackadelic-discreet-text-widget.php:25
  85. Address and Google Map Widget icon Address and Google Map Widget10+ installs apply_filters( 'widget_text', $widget_text, $instance, $this ) rbrother-google-map.php:36
  86. Melabu WP Latest Posts Slides icon Melabu WP Latest Posts Slides10+ installs apply_filters( 'widget_text', $instance['description'] ) classes/class.MelibuLPSshortWidget.php:49
  87. News Ticker Anywhere icon News Ticker Anywhere10+ installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance, $this ) template/widget-news-ticker.php:41
  88. Contextual Category Widget icon Contextual Category Widget10+ installs apply_filters( 'widget_text', wpautop( $description ), $instance, $this ) contextual-category-widget.php:74
  89. Plugin Name: GMO Widget Custom icon Plugin Name: GMO Widget Custom10+ installs apply_filters( 'widget_text', $instance['description'], $args, $instance ) gmo-widget-custom.php:69
  90. Steam Community Group Widget icon Steam Community Group Widget10+ installs apply_filters( 'widget_text', $instance['adress'] ) steam-group-widget.php:51
  91. Qazana Layout builder for WordPress icon Qazana Layout builder for WordPress10+ installs apply_filters( 'widget_text', $content, $this->get_settings() ) includes/widgets/base/widget-base.php:411
  92. Discordian Date Function icon Discordian Date Function10+ installs apply_filters( 'widget_text', isset($instance['body']) ) ddatefunc.php:293
  93. Content Sidebars icon Content Sidebars10+ installs apply_filters( 'widget_text', $instance['text'], $instance, $this ) content-sidebars.php:2048
  94. Devinlabs Unit Conventer icon Devinlabs Unit Conventer10+ installs apply_filters( 'widget_text', $widget_text, $instance, $this ) devinlabs-unit-converter.php:36
  95. KS Ads Widget icon KS Ads Widget10+ installs apply_filters( 'widget_text', $instance['description'], $args, $instance ) ks-ads-widget.php:104
  96. Haxy Image Widget icon Haxy Image Widget10+ installs apply_filters( 'widget_text', $instance['rel_attribute'], $instance, $this->id_base ) includes/class-hexy-image-widget.php:87
  97. OrbitCarrot CTA Widget Manager icon OrbitCarrot CTA Widget Manager10+ installs apply_filters( 'widget_text', $instance['text'] ) cta-widgetmanager.php:116
  98. GridBox Elementor Widgets icon GridBox Elementor WidgetsFewer than 10 installs apply_filters( 'widget_text', $content ) includes/functions.php:20
  99. Arashtad Testimonials Slider Plugin icon Arashtad Testimonials Slider PluginFewer than 10 installs apply_filters( 'widget_text', $instance['animation_duration'] ) arashtad-testimonials-slider.php:75
  100. Arashtad Accordion Plugin icon Arashtad Accordion PluginFewer than 10 installs apply_filters( 'widget_text', $instance['style'] ) arashtad-accordion.php:74
  101. Arashtad Tabs Plugin icon Arashtad Tabs PluginFewer than 10 installs apply_filters( 'widget_text', $instance['style'] ) arashtad-tabs.php:70
  102. Arashtad Toggle Plugin icon Arashtad Toggle PluginFewer than 10 installs apply_filters( 'widget_text', $instance['style'] ) arashtad-toggle.php:70
  103. Dataclermont Bootstrap Widgets icon Dataclermont Bootstrap WidgetsFewer than 10 installs apply_filters( 'widget_text', $instance['text'] ) widgets/featured_section_inverted.php:20
  104. WP-Trader icon WP-TraderFewer than 10 installs apply_filters( 'widget_text', $instance['text'] ) widgets/latest-uploads-widget.php:39
  105. Tattoo Shop Manager icon Tattoo Shop ManagerFewer than 10 installs apply_filters( 'widget_text', $instance['text'] ) inc/shortcodes_widgets.php:55
  106. Frontaccounting connect icon Frontaccounting connectFewer than 10 installs apply_filters( 'widget_text', trim($instance['item_num']) ) FACWidget.php:66
  107. Ajax Message icon Ajax MessageFewer than 10 installs apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) ajax-message.php:507
  108. Pick-n-Post Quote icon Pick-n-Post QuoteFewer than 10 installs apply_filters( 'widget_text', $instance['separator'] ) pick-n-post-quote.php:270
  109. Tiny’R’Sid adapter icon Tiny’R’Sid adapterFewer than 10 installs apply_filters( 'widget_text', $instance['text'] ) tinyrsid-adapter.php:79
  110. WP Post List Widget icon WP Post List WidgetFewer than 10 installs apply_filters( 'widget_text', $output ) wp-post-list-widget.php:83
  111. WebCL Widget icon WebCL WidgetFewer than 10 installs apply_filters( 'widget_text', $instance['text'] ) webcl-widget.php:45
  112. FT TriOutNC icon FT TriOutNCFewer than 10 installs apply_filters( 'widget_text', $instance['text'], $instance ) ft-trioutnc.php:59

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.