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).

What listeners filter

Kind (beat / kit), genre, mood, BPM range, search, and playlist. See Filters.

Appearance

BeatStore → Settings: 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 kind (beat vs kit) and playlists instead.

Catalog JSON the player uses: REST API.