Title: is_post_embeddable
Published: April 28, 2025
Last modified: February 24, 2026

---

# is_post_embeddable( int|WP_Post|null $post = null ): bool

## In this article

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

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

Determines whether a post is embeddable.

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

 `$post`int|[WP_Post](https://developer.wordpress.org/reference/classes/wp_post/)
|nulloptional

Post ID or `WP_Post` object. Defaults to global $post.

Default:`null`

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

 bool Whether the post should be considered embeddable.

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

    ```php
    function is_post_embeddable( $post = null ) {
    	$post = get_post( $post );

    	if ( ! $post ) {
    		return false;
    	}

    	$post_type = get_post_type_object( $post->post_type );

    	if ( ! $post_type ) {
    		return false;
    	}

    	$is_embeddable = $post_type->embeddable;

    	/**
    	 * Filter whether a post is embeddable.
    	 *
    	 * @since 6.8.0
    	 *
    	 * @param bool    $is_embeddable Whether the post is embeddable.
    	 * @param WP_Post $post          Post object.
    	 */
    	return apply_filters( 'is_post_embeddable', $is_embeddable, $post );
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/post.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/post.php#L2529)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/post.php#L2529-L2553)

## 󠀁[Hooks](https://developer.wordpress.org/reference/functions/is_post_embeddable/?output_format=md#hooks)󠁿

 [apply_filters( ‘is_post_embeddable’, bool $is_embeddable, WP_Post $post )](https://developer.wordpress.org/reference/hooks/is_post_embeddable/)

Filter whether a post is embeddable.

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

| Uses | Description | 
| [apply_filters()](https://developer.wordpress.org/reference/functions/apply_filters/)`wp-includes/plugin.php` |

Calls the callback functions that have been added to a filter hook.

  | 
| [get_post()](https://developer.wordpress.org/reference/functions/get_post/)`wp-includes/post.php` |

Retrieves post data given a post ID or post object.

  | 
| [get_post_type_object()](https://developer.wordpress.org/reference/functions/get_post_type_object/)`wp-includes/post.php` |

Retrieves a post type object by name.

  |

[Show 1 more](https://developer.wordpress.org/reference/functions/is_post_embeddable/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/is_post_embeddable/?output_format=md#)

| Used by | Description | 
| [wp_oembed_add_discovery_links()](https://developer.wordpress.org/reference/functions/wp_oembed_add_discovery_links/)`wp-includes/embed.php` |

Adds oEmbed discovery links in the head element of the website.

  | 
| [get_oembed_response_data()](https://developer.wordpress.org/reference/functions/get_oembed_response_data/)`wp-includes/embed.php` |

Retrieves the oEmbed response data for a given post.

  |

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

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

## User Contributed Notes

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