Playlist

Embed a simple playlist.

• Name: core/playlist
• Category: media
• API Version: 3
• Block Type: Hybrid (static save + server enhancements)
• Keywords: music, sound

Block Relationships

Allowed inner blocks:
– core/playlist-track

Attributes

Defined via the attributes property in block.json.

Supports

Defined via the supports property in block.json.

• anchor: true
• align: true
• background:
  • backgroundImage: true
  • backgroundSize: true
  • gradient: true
• color:
  • gradients: true
  • link: true
• dimensions:
  • minHeight: true
  • minWidth: true
• interactivity: true
• shadow: true
• spacing:
  • margin: true
  • padding: true
• typography:
  • fontSize: true

Context

Defined via the usesContext and providesContext properties in block.json.

Provides context:

• showArtists → attribute showArtists
• showImages → attribute showImages

Block Markup

This is a hybrid block. It saves static markup that the server may enhance during rendering.

<!-- wp:core/playlist {"caption":"Sample playlist"} -->
<figure class="wp-block-playlist">
    <ol class="wp-block-playlist__tracklist wp-block-playlist__tracklist-show-numbers">
        <!-- wp:core/playlist-track {"id":123,"src":"https://example.com/audio.mp3","album":"Example album","artist":"Example creator","image":"https://example.com/track-image.jpg","imageAlt":"Track image","length":"3:21","title":"Sample track"} /-->
    </ol>
    <figcaption class="wp-element-caption">Sample playlist</figcaption>
</figure>
<!-- /wp:core/playlist -->

Source

• block.json (reference)
• Source directory — browse the edit and save source files, index.php, and more.