Player

4.x is one player (<beatstore-player>). Shortcode, block, Place Player, and the off-site iframe all render it.

Shortcode

[beatstore]

[beatstore-3] and [beatstore-2] are aliases so old pages keep working. Prefer [beatstore].

Attribute	Example	Notes
`limit`	`limit="24"`	Page size (max 40)
`playlist`	`playlist="12"`	Playlist post ID
`kind`	`kind="kit"`	Kind slug
`genre`	`genre="hip-hop"`	Genre slug
`mood`	`mood="dark"`	Mood slug

Example: [beatstore playlist="12" kind="kit"].

BeatStore → Place Player and the BeatStore Player block expose tracks per page, playlist, kind. genre and mood still work on the shortcode and on /beatstore-embed/?genre=… — they are just not in those builders. Elementor: drop a Shortcode widget and paste [beatstore].

Off-site embed

Copy the iframe from Place Player, or:

https://yoursite.com/beatstore-embed/?playlist=12&kind=kit

Legacy /htmlwidget3 and /htmlwidget2 URLs load the same player. Play stays in the iframe. Buy adds the chosen license via /beatstore-buy/ and opens checkout in the top window (no cart inside the iframe). The mini player and the search bar stay at the bottom of the iframe. The track list scrolls inside the frame.

What listeners filter

Kind (beat / kit, or the labels you set under BeatStore → Settings → Catalog types), genre, mood, BPM range, search, and playlist. See Filters.

Appearance

BeatStore → Settings: producer name, optional store announcement (info button next to the name), accent, light / dark / auto, default number of tracks per page.

Removed in 4.x

Widget 2 / 3 / 4 as separate players
Producer banner and visualizer
Player Nav Categories (EDD/Woo categories as player tabs + list/grid style). Use Catalog types and playlists instead.

Catalog JSON the player uses: REST API.