Title: WP_View_Config_Data::remove_list_member
Published: August 20, 2026

---

# WP_View_Config_Data::remove_list_member( array $members, mixed $identity ): array

## In this article

 * [Parameters](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#wp--skip-link--target)

This function’s access is marked private. This means it is not intended for use 
by plugin or theme developers, only by core. It is listed here for completeness.

Removes the first list member matching an identity, leaving the rest.

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#parameters)󠁿

 `$members`arrayrequired

The current list.

`$identity`mixedrequired

The identity of the member to remove.

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#return)󠁿

 array The list with the matching member removed, if any.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#source)󠁿

    ```php
    private function remove_list_member( array $members, $identity ) {
    	foreach ( $members as $index => $member ) {
    		if ( $this->list_item_identity( $member ) === (string) $identity ) {
    			unset( $members[ $index ] );
    			break;
    		}
    	}

    	return $members;
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-view-config-data.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.1/src/wp-includes/class-wp-view-config-data.php#L644)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.1/src/wp-includes/class-wp-view-config-data.php#L644-L653)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#related)󠁿

| Uses | Description | 
| [WP_View_Config_Data::list_item_identity()](https://developer.wordpress.org/reference/classes/wp_view_config_data/list_item_identity/)`wp-includes/class-wp-view-config-data.php` |

Resolves the identity used to match a list member against another.

  |

| Used by | Description | 
| [WP_View_Config_Data::remove_properties()](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_properties/)`wp-includes/class-wp-view-config-data.php` |

Removes the properties a spec names from the current value.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_view_config_data/remove_list_member/?output_format=md#changelog)󠁿

| Version | Description | 
| [7.1.0](https://developer.wordpress.org/reference/since/7.1.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_view_config_data%2Fremove_list_member%2F)
before being able to contribute a note or feedback.