get_post_custom_values() – Function | Developer.WordPress.org

Retrieves values for a custom post field.

Description

The parameters must not be considered optional. All of the post meta fields will be retrieved and only the meta field key values returned.

Parameters

$keystringoptional: Meta field key.
Default:''
$post_idintoptional: Post ID. Default is the ID of the global $post.

Return

array|null Meta field values.

Source

 * @return mixed An array of values.
 *               False for an invalid `$post_id` (non-numeric, zero, or negative value).
 *               An empty string if a valid but non-existing post ID is passed.
 */
function get_post_custom( $post_id = 0 ) {
	$post_id = absint( $post_id );

	if ( ! $post_id ) {
		$post_id = get_the_ID();

View all references View on Trac View on GitHub

Changelog

Version	Description
1.2.0	Introduced.

User Contributed Notes

Skip to note 2 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
Default usage example.

Let’s assume the current post has 3 values associated with the (custom) field my_key.

You could show them through:
```
$mykey_values = get_post_custom_values( 'my_key' );

foreach ( $mykey_values as $key => $value ) {
	echo "$key => $value ( 'my_key' )<br />"; 
}
```
The above example will output:
```
0 => First value ( 'my_key' )
1 => Second value ( 'my_key' )
2 => Third value ( 'my_key' )
```
Log in to add feedback

get_post_custom_values( string $key = '', int $post_id ): array|null

In this article