Docs & Support

Learn about all the Formidable features and get support from our amazing customer success team.

frm_filtered_lookup_options

Heads up! This article contains PHP code and is intended for developers. We offer this code as a courtesy, but don't provide support for code customizations or 3rd party development.

Modify the options included in a lookup field before they are displayed in the form.

Usage

add_filter( 'frm_filtered_lookup_options', 'change_lookup_options', 10, 2 );

Formidable Forms makes advanced site building simple. Launch forms, directories, dashboards, and custom WordPress apps faster than ever before.

Parameters

  • $field (object) : The field the lookup field is using.
  • $args (array)
    • limit (int): The maximum number of options to include in the lookup field.

Examples

Add extra content to lookup options

This example adds more content around the values shown in a lookup field. It changes the options like '2.1', '2.2' to 'Version 2.1 is updated', 'Version 2.2 is updated'.

add_filter( 'frm_filtered_lookup_options', 'change_lookup_options', 10, 2 );
function change_lookup_options( $options, $args ) {
  if ( $args['field']->id == 25 ) { // change 25 to the id of the field in the other form
    foreach ( $options as $k => $option ) {
      $options[ $k ] = 'Version ' . $option . ' is updated';
    }
  }
  return $options;
}

Display User ID field with display name and ID in Lookup Field

There may be times when you want to use a Lookup field mapped to a User ID field from another form. By default, the User ID is shown rather than the display name. You can show the display name and the user ID as options with this example.

add_filter( 'frm_filtered_lookup_options', 'change_lookup_options', 10, 2 );
function change_lookup_options( $options, $args ) {
  if ( $args['field']->id == 808) { // change 808 to the id of the user ID field from the other form
    foreach ( $options as $k => $option ) {
      $user = get_user_by('id', $option);
      $value = $user->display_name;
      $options[ $k ] = $value . ' - ID ' . $option;
    }
  }
  return $options;
}

Replace 808 with the User ID field in your other form (the one that the lookup field is mapped to).

Populate with uploaded image path

This example will populate a lookup field with uploaded image path

add_filter( 'frm_filtered_lookup_options', 'change_lookup_options', 10, 2 );
function change_lookup_options( $options, $args ) {
    if ( $args['field']->id === '25' ) { // change 25 to the ID of the file upload field ID in the other form
        foreach ( $options as $k => $option ) {
            $options[ $k ] = wp_get_attachment_url( $option );
        }
    }

    return $options;
}

Change Log

Added in version 3.0.06

Was this article helpful? *

This article may contain affiliate links. Once in a while, we earn commissions from those links. But we only recommend products we like, with or without commissions.

In this article

    We have a small, but amazing team of dedicated people who are committed to helping you achieve your goals and project requirements.


    Copyright © 2025 Strategy11, LLC. Formidable Forms® is a registered trademark Strategy11, LLC.

    Complete your purchase
    Special offer unlocked.
    Get 55% OFF!
    Complete Purchase
    Join 400,000+ using Formidable Forms to create form-focused solutions fast. Get Formidable Forms