WordPress filter hook

acf/format_value

Fired by 46 WordPress plugins, running on 2.1M+ sites between them.

“Filters the $value for use in a template function.”

How to use acf/format_value

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

functions.php
add_filter( 'acf/format_value', function( $value, $post_id, $field ) {
	// Change $value here.
	return $value;
}, 10, 3 );

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

46 plugins that fire acf/format_value

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( 'acf/format_value', $value, $post_id, $field, $escape_html ) includes/acf-value-functions.php:200
  2. Secure Custom Fields icon Secure Custom Fields100,000+ installs apply_filters( 'acf/format_value', $value, $post_id, $field, $escape_html ) includes/acf-value-functions.php:191
  3. WPGraphQL for ACF icon WPGraphQL for ACF10,000+ installs apply_filters( 'acf/format_value', $value, $node_id, $field_config, false ) src/FieldConfig.php:476
  4. Mapster WP Maps icon Mapster WP Maps3,000+ installs apply_filters( 'acf/format_value', $value, $post_id, $field, $escape_html ) includes/acf/includes/acf-value-functions.php:200
  5. Advanced Views icon Advanced Views2,000+ installs apply_filters( 'acf/format_value', $value, $source->get_id(), acf_get_field( $field_id ), false ) src/Field_Provider/Acf/Acf_Data_Vendor.php:434
  6. WPScreens icon WPScreens300+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:139
  7. MapifyLite (by MapifyPro) icon MapifyLite (by MapifyPro)200+ installs apply_filters( 'acf/format_value', $value, $post_id, $field, $escape_html ) lib/advanced-custom-fields/includes/acf-value-functions.php:172
  8. WP Related Posts and Products (WRI) icon WP Related Posts and Products (WRI)100+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) advanced-custom-fields/includes/acf-value-functions.php:141
  9. Flexblocks icon Flexblocks80+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) inc/acf/includes/acf-value-functions.php:172
  10. Dooodl icon Dooodl50+ installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) includes/libs/advanced-custom-fields/acf.php:787
  11. OneDS Start Package icon OneDS Start Package40+ installs apply_filters( 'acf/format_value', $value, $post_id, $field, $escape_html ) includes/acf/includes/acf-value-functions.php:172
  12. Social Influencer Links icon Social Influencer Links30+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) lib/acf/includes/acf-value-functions.php:141
  13. Tuxedo Importer icon Tuxedo Importer20+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:172
  14. Accessibility Statement icon Accessibility Statement20+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:151
  15. Fancy Grid Portfolio icon Fancy Grid Portfolio20+ installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) lib/advanced-custom-fields/acf.php:771
  16. Simple Content Adder icon Simple Content Adder20+ installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) lib/advanced-custom-fields/acf.php:803
  17. TSA Commerce icon TSA Commerce20+ installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) vendors/acf/acf.php:811
  18. Rexpansive Builder icon Rexpansive Builder10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) admin/lib/acf/advanced-custom-fields/includes/acf-value-functions.php:172
  19. FloristPress for Woo icon FloristPress for Woo10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field, $escape_html ) lib/acf/includes/acf-value-functions.php:191
  20. Megabits Control Gastos icon Megabits Control Gastos10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:172
  21. WoWpi Guild icon WoWpi Guild10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:141
  22. Proshots For WooCommerce icon Proshots For WooCommerce10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:141
  23. Important Dates Dashboard Widget icon Important Dates Dashboard Widget10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:151
  24. Coronavirus (COVID-19) Live Update Popup icon Coronavirus (COVID-19) Live Update Popup10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:141
  25. Realty Pack Core icon Realty Pack Core10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) app/acf/includes/acf-value-functions.php:144
  26. Mufasa 🦁 Slider icon Mufasa 🦁 Slider10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:139
  27. LogicalDOC WordPress Explorer icon LogicalDOC WordPress Explorer10+ installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) advanced-custom-fields/acf.php:800
  28. Simply Documents icon Simply Documents10+ installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) lib/advanced-custom-fields/acf.php:831
  29. Church Options icon Church Options10+ installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) lib/advanced-custom-fields/acf.php:831
  30. Google Merchant Product Feed icon Google Merchant Product Feed10+ installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) test.php:777
  31. Schedule Tweets icon Schedule Tweets10+ installs apply_filters( 'acf/format_value', $value, $post_id, $field ) assets/plugins/acf/includes/api/api-value.php:350
  32. Simple KMDG Resource Center icon Simple KMDG Resource CenterFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/advanced-custom-fields/includes/acf-value-functions.php:139
  33. Admin Notes WP icon Admin Notes WPFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/advanced-custom-fields/includes/acf-value-functions.php:139
  34. Ninety in Ninety icon Ninety in NinetyFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) inc/acf/includes/acf-value-functions.php:141
  35. Admin User Control icon Admin User ControlFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:141
  36. Work Time Allocator icon Work Time AllocatorFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) lib/advanced-custom-fields/includes/acf-value-functions.php:141
  37. Dashboard Feeds Dashboard Widget icon Dashboard Feeds Dashboard WidgetFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:151
  38. Repeat Events icon Repeat EventsFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:141
  39. Quick Recommend icon Quick RecommendFewer than 10 installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) lib/advanced-custom-fields/acf.php:831
  40. ASD Feature Maps icon ASD Feature MapsFewer than 10 installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) includes/advanced-custom-fields/acf.php:811
  41. Flaunt Your Clients icon Flaunt Your ClientsFewer than 10 installs apply_filters( 'acf/format_value', $field['value'], $post_id, $field ) includes/advanced-custom-fields/acf.php:766
  42. Contact Form 7 Analytics icon Contact Form 7 AnalyticsFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) acf/api/api-value.php:308
  43. FeichtMedia ImageManager for Advanced Custom Fields icon FeichtMedia ImageManager for Advanced Custom FieldsFewer than 10 installs apply_filters( 'acf/format_value', $value, 0, $acf_field, false ) includes/class-graphql.php:269
  44. House Ads icon House AdsFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) lib/acf/includes/api/api-value.php:371
  45. NavThemes Gutenberg Blocks icon NavThemes Gutenberg BlocksFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) admin/includes/api/api-value.php:371
  46. NavThemes Employee Ratings icon NavThemes Employee RatingsFewer than 10 installs apply_filters( 'acf/format_value', $value, $post_id, $field ) admin/includes/api/api-value.php:371

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.