Adding Custom Fields to WordPress JSON API

I’m working on building out some cool annotations tools for different types of audio, mostly music, which you can see an example of here. Although this is a good step, to really make this app/plugin/tool extensible and reusable, there needs to be some sort of back end layer to store some meta data about each one of the audio segments.

Since VCU uses WordPress a lot, and the WP REST API has grown much more sophisticated over the years, I thought it would be a good option to create a custom post type for these types of audio annotations and store the metadata using some custom fields. It was easy enough to make the custom post type available through the API using the Custom Post Type UI plugin, but there was more involved to get the custom fields to show up in the JSON response for each post.

There was a lot of outdated stuff out there, and even the official docs don’t really offer a whole lot of clarity, so here is the code I added to functions.php to get the custom fields in the JSON response:

function song_get_post_meta_cb($object, $field_name, $request){
        return get_post_meta($object['id'], $field_name, true); 

function song_update_post_meta_cb($value, $object, $field_name){
  return update_post_meta($object['id'], $field_name, $value); 

add_action('rest_api_init', function(){

  register_rest_field('song', 'song_segments', 
    'get_callback' => 'song_get_post_meta_cb', 
    'update_callback' => 'song_update_post_meta_cb', 
    'schema' => null


You can just modify this and drop it into whatever part of the code is called when WP is bootstrapped. First we define two functions that return the result of calls to the WP methods to get/update post metadata. Then we add an action on the ‘rest_api_init’ hook that uses the method ‘register_rest_field’ to link our post type with the custom field key and the callbacks for reading/updating.

Beware that other examples out there are using the older and now deprecated method ‘register_api_field’ instead of ‘register_rest_field.’

12 thoughts on “Adding Custom Fields to WordPress JSON API”

  1. Tom says:

    Ha! I used this today.

    1. BrownBearWhatDoYouSee says:

      Glad it helped someone out LOL. Originally wrote this up for the Audiography plugin, but went the shortcode route, so this got tossed aside.

  2. Nabil says:

    It’s work like a migic, thank’s a lot Bro.
    But can you help me with make this data protected for unauthorised users?

    1. BrownBearWhatDoYouSee says:

      I might need more details about what you want to do to give a solid recommendation. You might be able to make a filter or something and check for the WP nonce when requesting certain endpoints.

  3. Dedly says:

    YAS. This helped a lot. Thanks x

  4. muzi says:

    thanks for posting, this helped me 😀

    1. BrownBearWhatDoYouSee says:

      Awesome, glad it helped. Thanks for commenting!

  5. Kevin says:

    Thank you, helped me alot!

    1. BrownBearWhatDoYouSee says:

      Glad it helped you, thanks for reading!

Leave a Reply

Your email address will not be published. Required fields are marked *