WordPress action & filter hook

acf/update_field

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

“Filters the $field array before it is updated.”

How to use acf/update_field

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( 'acf/update_field', function( $field ) {
	// Change $field here.
	return $field;
}, 10, 1 );

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.

32 plugins that fire acf/update_field

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/update_field', $field ) includes/acf-field-functions.php:1147
  2. Secure Custom Fields icon Secure Custom Fields100,000+ installs apply_filters( 'acf/update_field', $field ) includes/acf-field-functions.php:1145
  3. Mapster WP Maps icon Mapster WP Maps3,000+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:1039
  4. ACF Color Swatches icon ACF Color Swatches1,000+ installs do_action( 'acf/update_field', $field, $field['field_group'] ) acf-swatch-v4.php:241
  5. WPScreens icon WPScreens300+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:971
  6. MapifyLite (by MapifyPro) icon MapifyLite (by MapifyPro)200+ installs apply_filters( 'acf/update_field', $field ) lib/advanced-custom-fields/includes/acf-field-functions.php:1015
  7. WP Related Posts and Products (WRI) icon WP Related Posts and Products (WRI)100+ installs apply_filters( 'acf/update_field', $field ) advanced-custom-fields/includes/acf-field-functions.php:971
  8. Flexblocks icon Flexblocks80+ installs apply_filters( 'acf/update_field', $field ) inc/acf/includes/acf-field-functions.php:1007
  9. Dooodl icon Dooodl50+ installs do_action( 'acf/update_field', $field, $post_id ) includes/libs/advanced-custom-fields/core/controllers/field_group.php:906
  10. OneDS Start Package icon OneDS Start Package40+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:1015
  11. Social Influencer Links icon Social Influencer Links30+ installs apply_filters( 'acf/update_field', $field ) lib/acf/includes/acf-field-functions.php:971
  12. Tuxedo Importer icon Tuxedo Importer20+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:981
  13. Accessibility Statement icon Accessibility Statement20+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:981
  14. Fancy Grid Portfolio icon Fancy Grid Portfolio20+ installs do_action( 'acf/update_field', $field, $post_id ) lib/advanced-custom-fields/core/controllers/field_group.php:853
  15. Simple Content Adder icon Simple Content Adder20+ installs do_action( 'acf/update_field', $field, $post_id ) lib/advanced-custom-fields/core/controllers/field_group.php:912
  16. TSA Commerce icon TSA Commerce20+ installs do_action( 'acf/update_field', $field, $post_id ) vendors/acf/core/controllers/field_group.php:912
  17. FloristPress for Woo icon FloristPress for Woo10+ installs apply_filters( 'acf/update_field', $field ) lib/acf/includes/acf-field-functions.php:1015
  18. Rexpansive Builder icon Rexpansive Builder10+ installs apply_filters( 'acf/update_field', $field ) admin/lib/acf/advanced-custom-fields/includes/acf-field-functions.php:981
  19. Megabits Control Gastos icon Megabits Control Gastos10+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:1007
  20. WoWpi Guild icon WoWpi Guild10+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:971
  21. Proshots For WooCommerce icon Proshots For WooCommerce10+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:971
  22. Important Dates Dashboard Widget icon Important Dates Dashboard Widget10+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:981
  23. Coronavirus (COVID-19) Live Update Popup icon Coronavirus (COVID-19) Live Update Popup10+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:971
  24. Realty Pack Core icon Realty Pack Core10+ installs apply_filters( 'acf/update_field', $field ) app/acf/includes/acf-field-functions.php:968
  25. Mufasa 🦁 Slider icon Mufasa 🦁 Slider10+ installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:971
  26. LogicalDOC WordPress Explorer icon LogicalDOC WordPress Explorer10+ installs do_action( 'acf/update_field', $field, $post_id ) advanced-custom-fields/core/controllers/field_group.php:912
  27. Simply Documents icon Simply Documents10+ installs do_action( 'acf/update_field', $field, $post_id ) lib/advanced-custom-fields/core/controllers/field_group.php:912
  28. Church Options icon Church Options10+ installs do_action( 'acf/update_field', $field, $post_id ) lib/advanced-custom-fields/core/controllers/field_group.php:912
  29. Schedule Tweets icon Schedule Tweets10+ installs apply_filters( 'acf/update_field', $field ) assets/plugins/acf/includes/api/api-field.php:1247
  30. Simple KMDG Resource Center icon Simple KMDG Resource CenterFewer than 10 installs apply_filters( 'acf/update_field', $field ) includes/advanced-custom-fields/includes/acf-field-functions.php:971
  31. Admin Notes WP icon Admin Notes WPFewer than 10 installs apply_filters( 'acf/update_field', $field ) includes/acf/advanced-custom-fields/includes/acf-field-functions.php:971
  32. Ninety in Ninety icon Ninety in NinetyFewer than 10 installs apply_filters( 'acf/update_field', $field ) inc/acf/includes/acf-field-functions.php:971
  33. Admin User Control icon Admin User ControlFewer than 10 installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:971
  34. Work Time Allocator icon Work Time AllocatorFewer than 10 installs apply_filters( 'acf/update_field', $field ) lib/advanced-custom-fields/includes/acf-field-functions.php:971
  35. Dashboard Feeds Dashboard Widget icon Dashboard Feeds Dashboard WidgetFewer than 10 installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:981
  36. Repeat Events icon Repeat EventsFewer than 10 installs apply_filters( 'acf/update_field', $field ) includes/acf/includes/acf-field-functions.php:971
  37. Quick Recommend icon Quick RecommendFewer than 10 installs do_action( 'acf/update_field', $field, $post_id ) lib/advanced-custom-fields/core/controllers/field_group.php:912
  38. ASD Feature Maps icon ASD Feature MapsFewer than 10 installs do_action( 'acf/update_field', $field, $post_id ) includes/advanced-custom-fields/core/controllers/field_group.php:912
  39. Flaunt Your Clients icon Flaunt Your ClientsFewer than 10 installs do_action( 'acf/update_field', $field, $post_id ) includes/advanced-custom-fields/core/controllers/field_group.php:917
  40. Contact Form 7 Analytics icon Contact Form 7 AnalyticsFewer than 10 installs apply_filters( 'acf/update_field', $field ) acf/api/api-field.php:1190
  41. House Ads icon House AdsFewer than 10 installs apply_filters( 'acf/update_field', $field ) lib/acf/includes/api/api-field.php:1304
  42. NavThemes Gutenberg Blocks icon NavThemes Gutenberg BlocksFewer than 10 installs apply_filters( 'acf/update_field', $field ) admin/includes/api/api-field.php:1304
  43. NavThemes Employee Ratings icon NavThemes Employee RatingsFewer than 10 installs apply_filters( 'acf/update_field', $field ) admin/includes/api/api-field.php:1304

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.