WordPress filter hook · part of WordPress core

mce_buttons_2

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

“Filters the second-row list of TinyMCE buttons (Visual tab).”

How to use mce_buttons_2

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

functions.php
add_filter( 'mce_buttons_2', function( $mce_buttons_2, $editor_id ) {
	// Change $mce_buttons_2 here.
	return $mce_buttons_2;
}, 10, 2 );

Argument names come from Advanced Custom Fields (ACF®)'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 →

49 plugins that fire mce_buttons_2

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

  1. Advanced Custom Fields (ACF®) icon Advanced Custom Fields (ACF®)2+ million installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/fields/class-acf-field-wysiwyg.php:115
  2. SiteOrigin Widgets Bundle icon SiteOrigin Widgets Bundle400,000+ installs apply_filters( 'mce_buttons_2', $this->mce_buttons_2, $this->element_id ) base/inc/fields/tinymce.class.php:369
  3. Secure Custom Fields icon Secure Custom Fields100,000+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/fields/class-acf-field-wysiwyg.php:107
  4. ACF Frontend Admin by DynamiApps icon ACF Frontend Admin by DynamiApps8,000+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) main/frontend/fields/post/class-post-content.php:114
  5. Mapster WP Maps icon Mapster WP Maps3,000+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:115
  6. WPScreens icon WPScreens300+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:120
  7. MapifyLite (by MapifyPro) icon MapifyLite (by MapifyPro)200+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) lib/advanced-custom-fields/includes/fields/class-acf-field-wysiwyg.php:106
  8. MRW Simplified Editor icon MRW Simplified Editor100+ installs apply_filters( 'mce_buttons_2', array() ) inc/block-editor.php:248
  9. WP Related Posts and Products (WRI) icon WP Related Posts and Products (WRI)100+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) advanced-custom-fields/includes/fields/class-acf-field-wysiwyg.php:135
  10. Flexblocks icon Flexblocks80+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) inc/acf/includes/fields/class-acf-field-wysiwyg.php:116
  11. Neat Slider icon Neat Slider70+ installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'justifyfull', 'forecolor', 'pastetext', 'pasteword', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) php/class-fieldmanager-richtextarea.php:152
  12. Dooodl icon Dooodl50+ installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) includes/libs/advanced-custom-fields/core/fields/wysiwyg.php:121
  13. OneDS Start Package icon OneDS Start Package40+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:106
  14. Social Influencer Links icon Social Influencer Links30+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) lib/acf/includes/fields/class-acf-field-wysiwyg.php:120
  15. Fancy Grid Portfolio icon Fancy Grid Portfolio20+ installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) lib/advanced-custom-fields/core/fields/wysiwyg.php:137
  16. Simple Content Adder icon Simple Content Adder20+ installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) lib/advanced-custom-fields/core/fields/wysiwyg.php:122
  17. TSA Commerce icon TSA Commerce20+ installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) vendors/acf/core/fields/wysiwyg.php:122
  18. Tuxedo Importer icon Tuxedo Importer20+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:116
  19. Accessibility Statement icon Accessibility Statement20+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:116
  20. LogicalDOC WordPress Explorer icon LogicalDOC WordPress Explorer10+ installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) advanced-custom-fields/core/fields/wysiwyg.php:122
  21. Simply Documents icon Simply Documents10+ installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) lib/advanced-custom-fields/core/fields/wysiwyg.php:122
  22. Church Options icon Church Options10+ installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) lib/advanced-custom-fields/core/fields/wysiwyg.php:122
  23. FloristPress for Woo icon FloristPress for Woo10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) lib/acf/includes/fields/class-acf-field-wysiwyg.php:106
  24. Rexpansive Builder icon Rexpansive Builder10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) admin/lib/acf/advanced-custom-fields/includes/fields/class-acf-field-wysiwyg.php:116
  25. Schedule Tweets icon Schedule Tweets10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) assets/plugins/acf/includes/fields/class-acf-field-wysiwyg.php:146
  26. Megabits Control Gastos icon Megabits Control Gastos10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:116
  27. WoWpi Guild icon WoWpi Guild10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:120
  28. Proshots For WooCommerce icon Proshots For WooCommerce10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:120
  29. Important Dates Dashboard Widget icon Important Dates Dashboard Widget10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:116
  30. Coronavirus (COVID-19) Live Update Popup icon Coronavirus (COVID-19) Live Update Popup10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:135
  31. Realty Pack Core icon Realty Pack Core10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) app/acf/includes/fields/class-acf-field-wysiwyg.php:135
  32. Mufasa 🦁 Slider icon Mufasa 🦁 Slider10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:120
  33. Massoftind Custom Fields & Field Builder icon Massoftind Custom Fields & Field Builder10+ installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) fields/Types/WysiwygField.php:224
  34. Artbees Product Tabs for WooCommerce icon Artbees Product Tabs for WooCommerceFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, self::EDITOR_ID ) src/Admin/TabContentEditorSettings.php:82
  35. Mighty Portfolio icon Mighty PortfolioFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2 ) framework/cantoframework.php:132
  36. Simple KMDG Resource Center icon Simple KMDG Resource CenterFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/advanced-custom-fields/includes/fields/class-acf-field-wysiwyg.php:120
  37. Quick Recommend icon Quick RecommendFewer than 10 installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) lib/advanced-custom-fields/core/fields/wysiwyg.php:122
  38. ASD Feature Maps icon ASD Feature MapsFewer than 10 installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) includes/advanced-custom-fields/core/fields/wysiwyg.php:122
  39. Admin Notes WP icon Admin Notes WPFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/advanced-custom-fields/includes/fields/class-acf-field-wysiwyg.php:120
  40. Contact Form 7 Analytics icon Contact Form 7 AnalyticsFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) acf/fields/wysiwyg.php:176
  41. Ninety in Ninety icon Ninety in NinetyFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) inc/acf/includes/fields/class-acf-field-wysiwyg.php:135
  42. Admin User Control icon Admin User ControlFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:135
  43. Work Time Allocator icon Work Time AllocatorFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) lib/advanced-custom-fields/includes/fields/class-acf-field-wysiwyg.php:120
  44. House Ads icon House AdsFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) lib/acf/includes/fields/class-acf-field-wysiwyg.php:135
  45. NavThemes Gutenberg Blocks icon NavThemes Gutenberg BlocksFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) admin/includes/fields/class-acf-field-wysiwyg.php:135
  46. NavThemes Employee Ratings icon NavThemes Employee RatingsFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) admin/includes/fields/class-acf-field-wysiwyg.php:135
  47. Flaunt Your Clients icon Flaunt Your ClientsFewer than 10 installs apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'justifyfull', 'forecolor', 'pastetext', 'pasteword', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help', 'code' ), $editor_id ) includes/advanced-custom-fields/core/fields/wysiwyg.php:75
  48. Dashboard Feeds Dashboard Widget icon Dashboard Feeds Dashboard WidgetFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:116
  49. Repeat Events icon Repeat EventsFewer than 10 installs apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ) includes/acf/includes/fields/class-acf-field-wysiwyg.php:120

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.