WordPress filter hook

acf/load_value

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

“Filters the $value after it has been loaded.”

How to use acf/load_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/load_value', function( $value, $post_id, $field ) {
	// Change $value here.
	return $value;
}, 10, 3 );

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.

45 plugins that fire acf/load_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/load_value', $value, $post_id, $field ) includes/acf-value-functions.php:146
  2. Secure Custom Fields icon Secure Custom Fields100,000+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf-value-functions.php:137
  3. ACF Frontend Admin by DynamiApps icon ACF Frontend Admin by DynamiApps8,000+ installs apply_filters( 'acf/load_value', $value, $object_id, $field ) main/frontend/forms/classes/display.php:1041
  4. Mapster WP Maps icon Mapster WP Maps3,000+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:146
  5. WPScreens icon WPScreens300+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:87
  6. MapifyLite (by MapifyPro) icon MapifyLite (by MapifyPro)200+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) lib/advanced-custom-fields/includes/acf-value-functions.php:118
  7. WP Related Posts and Products (WRI) icon WP Related Posts and Products (WRI)100+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) advanced-custom-fields/includes/acf-value-functions.php:89
  8. Flexblocks icon Flexblocks80+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) inc/acf/includes/acf-value-functions.php:118
  9. Dooodl icon Dooodl50+ installs apply_filters( 'acf/load_value', false, $post_id, $field ) includes/libs/advanced-custom-fields/acf.php:786
  10. OneDS Start Package icon OneDS Start Package40+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:118
  11. Social Influencer Links icon Social Influencer Links30+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) lib/acf/includes/acf-value-functions.php:89
  12. Tuxedo Importer icon Tuxedo Importer20+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:118
  13. Accessibility Statement icon Accessibility Statement20+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:99
  14. Fancy Grid Portfolio icon Fancy Grid Portfolio20+ installs apply_filters( 'acf/load_value', false, $post_id, $field ) lib/advanced-custom-fields/acf.php:770
  15. Simple Content Adder icon Simple Content Adder20+ installs apply_filters( 'acf/load_value', false, $post_id, $field ) lib/advanced-custom-fields/acf.php:802
  16. TSA Commerce icon TSA Commerce20+ installs apply_filters( 'acf/load_value', false, $post_id, $field ) vendors/acf/acf.php:810
  17. Rexpansive Builder icon Rexpansive Builder10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) admin/lib/acf/advanced-custom-fields/includes/acf-value-functions.php:118
  18. FloristPress for Woo icon FloristPress for Woo10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) lib/acf/includes/acf-value-functions.php:137
  19. Megabits Control Gastos icon Megabits Control Gastos10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:118
  20. WoWpi Guild icon WoWpi Guild10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:89
  21. Proshots For WooCommerce icon Proshots For WooCommerce10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:89
  22. Important Dates Dashboard Widget icon Important Dates Dashboard Widget10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:99
  23. Coronavirus (COVID-19) Live Update Popup icon Coronavirus (COVID-19) Live Update Popup10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:89
  24. Realty Pack Core icon Realty Pack Core10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) app/acf/includes/acf-value-functions.php:92
  25. Mufasa 🦁 Slider icon Mufasa 🦁 Slider10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:87
  26. LogicalDOC WordPress Explorer icon LogicalDOC WordPress Explorer10+ installs apply_filters( 'acf/load_value', false, $post_id, $field ) advanced-custom-fields/acf.php:799
  27. Simply Documents icon Simply Documents10+ installs apply_filters( 'acf/load_value', false, $post_id, $field ) lib/advanced-custom-fields/acf.php:830
  28. Church Options icon Church Options10+ installs apply_filters( 'acf/load_value', false, $post_id, $field ) lib/advanced-custom-fields/acf.php:830
  29. Google Merchant Product Feed icon Google Merchant Product Feed10+ installs apply_filters( 'acf/load_value', false, $post_id, $field ) test.php:776
  30. Schedule Tweets icon Schedule Tweets10+ installs apply_filters( 'acf/load_value', $value, $post_id, $field ) assets/plugins/acf/includes/api/api-value.php:304
  31. Limit Revision Publishing icon Limit Revision Publishing10+ installs apply_filters( 'acf/load_value', $value, $pending_revision_id, $field ) lib/class-lrp-edit-form-controller.php:167
  32. Simple KMDG Resource Center icon Simple KMDG Resource CenterFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/advanced-custom-fields/includes/acf-value-functions.php:87
  33. Admin Notes WP icon Admin Notes WPFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/advanced-custom-fields/includes/acf-value-functions.php:87
  34. Ninety in Ninety icon Ninety in NinetyFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) inc/acf/includes/acf-value-functions.php:89
  35. Admin User Control icon Admin User ControlFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:89
  36. Work Time Allocator icon Work Time AllocatorFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) lib/advanced-custom-fields/includes/acf-value-functions.php:89
  37. Dashboard Feeds Dashboard Widget icon Dashboard Feeds Dashboard WidgetFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:99
  38. Repeat Events icon Repeat EventsFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) includes/acf/includes/acf-value-functions.php:89
  39. Quick Recommend icon Quick RecommendFewer than 10 installs apply_filters( 'acf/load_value', false, $post_id, $field ) lib/advanced-custom-fields/acf.php:830
  40. ASD Feature Maps icon ASD Feature MapsFewer than 10 installs apply_filters( 'acf/load_value', false, $post_id, $field ) includes/advanced-custom-fields/acf.php:810
  41. Flaunt Your Clients icon Flaunt Your ClientsFewer than 10 installs apply_filters( 'acf/load_value', false, $post_id, $field ) includes/advanced-custom-fields/acf.php:765
  42. Contact Form 7 Analytics icon Contact Form 7 AnalyticsFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) acf/api/api-value.php:262
  43. House Ads icon House AdsFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) lib/acf/includes/api/api-value.php:316
  44. NavThemes Gutenberg Blocks icon NavThemes Gutenberg BlocksFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) admin/includes/api/api-value.php:316
  45. NavThemes Employee Ratings icon NavThemes Employee RatingsFewer than 10 installs apply_filters( 'acf/load_value', $value, $post_id, $field ) admin/includes/api/api-value.php:316

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.