Title: WP_Widget_Media_Audio::render_media
Published: June 15, 2017
Last modified: May 20, 2026

---

# WP_Widget_Media_Audio::render_media( array $instance )

## In this article

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

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

Render the media on the frontend.

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

 `$instance`arrayrequired

Widget instance props.

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

    ```php
    public function render_media( $instance ) {
    	$instance   = array_merge( wp_list_pluck( $this->get_instance_schema(), 'default' ), $instance );
    	$attachment = null;

    	if ( $this->is_attachment_with_mime_type( $instance['attachment_id'], $this->widget_options['mime_type'] ) ) {
    		$attachment = get_post( $instance['attachment_id'] );
    	}

    	if ( $attachment ) {
    		$src = wp_get_attachment_url( $attachment->ID );
    	} else {
    		$src = $instance['url'];
    	}

    	echo wp_audio_shortcode(
    		array_merge(
    			$instance,
    			compact( 'src' )
    		)
    	);
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/widgets/class-wp-widget-media-audio.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/widgets/class-wp-widget-media-audio.php#L101)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/widgets/class-wp-widget-media-audio.php#L101-L121)

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

| Uses | Description | 
| [WP_Widget_Media_Audio::get_instance_schema()](https://developer.wordpress.org/reference/classes/wp_widget_media_audio/get_instance_schema/)`wp-includes/widgets/class-wp-widget-media-audio.php` |

Get schema for properties of a widget instance (item).

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

Plucks a certain field out of each object or array in an array.

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

Builds the Audio shortcode output.

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

Retrieves the URL for an attachment.

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

Retrieves post data given a post ID or post object.

  |

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

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

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

## User Contributed Notes

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