WordPress Plugin

LabelGrid Tools is the official WordPress plugin that automatically syncs your release catalog, artist profiles, and download gates from LabelGrid to your WordPress website. LabelGrid is the source of truth — the plugin imports your data every 6 hours, so your website always reflects your latest catalog.

Included with API plans

LabelGrid Tools is included with all API plans at no additional cost.

Overview

What you can do

Feature	Description
Automatic catalog sync	Releases, artists, and download gates sync from LabelGrid every 6 hours
Release pages	Landing pages with artwork and links to 25+ streaming platforms and stores
Artist profiles	Artist pages with biographies, social links, and discography
Release grids	Filterable grids of your catalog by genre, label, or artist
Release banners	Homepage banners showcasing your latest or featured releases
Spotify pre-save	Pre-save buttons with playlist and artist follow actions
Pre-orders	Support for iTunes, Apple Music, Beatport, Juno, and Amazon pre-orders
Download gates	Email capture gates with social follow actions (Spotify, Twitter, SoundCloud)
Spotify Web Player	Embedded Spotify player on release pages
Press releases	Dedicated press release sections on release pages
iTunes affiliate links	Earn commission on iTunes purchases through your site
Yoast SEO integration	Open Graph metadata for social sharing

Requirements

• WordPress 5.0 or higher
• PHP 8.0 or higher
• Active LabelGrid account with an API plan

---

Installation

From WordPress admin

1. Go to Plugins → Add New
2. Search for “LabelGrid Tools”
3. Click Install Now
4. Click Activate

Manual installation

1. Download the plugin from LabelGrid
2. Go to Plugins → Add New → Upload Plugin
3. Select the downloaded ZIP file
4. Click Install Now
5. Click Activate

---

Configuration

Getting your API key

Before configuring the plugin, create an authorization key in LabelGrid:

1. Log into LabelGrid
2. Click your user menu (your name/avatar in the top-right corner)
3. Click Wordpress from the dropdown menu
4. Click the Configure Plugin button
5. In Step 1: Create Key, select which labels to include:
   • Choose All My Labels to sync your entire catalog
   • Or select specific labels to limit what appears on your website
6. Click Create New Key
7. Enter your WordPress website domain (e.g., https://yoursite.com)
8. Click OK to generate the key
9. Copy the access token — you’ll need this for WordPress

Caution

Each key is tied to a specific domain. If you have multiple WordPress sites, create a separate key for each one.

Plugin settings

Go to Settings → LabelGrid Tools in your WordPress admin. The settings page has four tabs:

LabelGrid GATE tab

Setting	Description
API Token	Paste the access token you copied from LabelGrid

General Options tab

Setting	Description
Debug level	Set logging verbosity for troubleshooting
Log retention	How long to keep system logs
Auto-sync	Enable or disable automatic catalog synchronization
iTunes Affiliate Token	Your iTunes affiliate token for earning commission on purchases

Releases tab

Setting	Description
Show unreleased	Display upcoming releases on your site
Spotify pre-save	Enable Spotify pre-save buttons on unreleased content
Pre-save email collection	No / Yes (obligatory) / Yes (optional) — collect emails during pre-save
Pre-orders	Enable pre-order links for iTunes, Apple Music, Beatport, Juno, and Amazon
Spotify Web Player	Show embedded Spotify player on release pages
Press release	Display press release sections
Featured artists	Show featured artists on release pages
Similar releases	Display similar releases
Show below artwork	Choose what to display below artwork: release code or record label
Twitter feed on artists	Show Twitter feed on artist pages

Download Gate tab

Setting	Description
Press	Press visibility settings
Artists visibility	Control artist display on gate pages
Button label	Custom text for gate buttons
Welcome title	Title shown on the gate landing page
Welcome description	Description text for the gate landing page
Wizard button label	Text for the gate wizard button

---

Catalog sync

The plugin automatically syncs your catalog from LabelGrid every 6 hours. This includes releases, artists, and download gates.

The plugin creates three custom post types in WordPress:

Post type	Description	URL structure
Release	Music releases with artwork, metadata, and platform links	/release/release-name/
Artist	Artist profiles with biography and social links	/artist/artist-name/
Gate Download	Download gates with email capture	/free-download/gate-name/

Download gates also support a Gate Category taxonomy for organizing your gates into groups.

Note

LabelGrid is the source of truth. Edits you make to release or artist posts in WordPress will be overwritten on the next sync. Make all catalog changes in LabelGrid.

---

Shortcodes

The plugin provides 11 shortcodes organized into four categories: releases, artists, download gates, and pre-save.

Release shortcodes

[labelgrid-release-list]

Display your releases in a filterable grid.

Basic example:

[labelgrid-release-list items-page="12" items-row="4"]

Parameters:

Parameter	Default	Description
show-title	null	Show release titles
label	null	Filter by record label
items-page	12	Number of releases per page
items-row	4	Number of columns per row
pagination	null	Enable pagination
showcase-last	null	Enable showcase mode
item-filter	released	Filter type: released or unreleased
title-below	null	Position title below artwork
filter-artists	null	Filter by artist IDs
exclude	null	Exclude specific release IDs
image-quality	lgt_artwork_medium	Image size preset

Show upcoming releases:

[labelgrid-release-list item-filter="unreleased" items-row="3"]

[labelgrid-release-list-filter]

Add a dropdown filter above your release grid. Place this shortcode before [labelgrid-release-list] on the same page.

Basic example:

[labelgrid-release-list-filter]
[labelgrid-release-list items-page="12"]

Parameters:

Parameter	Default	Description
record_label	null	Show a record label filter dropdown

[labelgrid-release-banner]

Display a banner featuring one or more releases — ideal for homepages.

Basic example:

[labelgrid-release-banner items-page="1"]

Parameters:

Parameter	Default	Description
label	null	Filter by record label
items-page	1	Number of releases to show
item-filter	released	Filter type: released or unreleased
item-order	DESC	Sort order: DESC (newest first) or ASC
filter-artists	null	Filter by artist IDs
exclude	null	Exclude specific release IDs

[labelgrid-release-links]

Show streaming and store links for a specific release. Use this inside release page templates or on any page by specifying a release ID.

Basic example:

[labelgrid-release-links]

With a specific release:

[labelgrid-release-links release-id="123" artists="true"]

Parameters:

Parameter	Default	Description
release-id	Current post ID	The release post ID
artists	null	Show artist information alongside links

[labelgrid-release-detail]

Render the full release detail page, including artwork, metadata, platform links, and embedded player. This shortcode uses the current post and takes no parameters.

Example (in a release template):

[labelgrid-release-detail]

Artist shortcodes

[labelgrid-artist-list]

Display your artists in a grid layout.

Basic example:

[labelgrid-artist-list items-page="8" items-row="4"]

Parameters:

Parameter	Default	Description
show-title	false	Show artist names below images
category	null	Filter by category
items-page	12	Number of artists per page
items-row	4	Number of columns per row
pagination	null	Enable pagination
title-below	null	Position title below image

[labelgrid-artist-detail]

Render the full artist profile page, including biography, social links, and discography. This shortcode uses the current post and takes no parameters.

Example (in an artist template):

[labelgrid-artist-detail]

Download gate shortcodes

[labelgrid-gate-button]

Display a download gate button. When clicked, the visitor goes through the gate flow (email capture and optional social follows) before getting access to the download.

Basic example:

[labelgrid-gate-button]

With custom text:

[labelgrid-gate-button gate-id="45" button-label="Get Free Download" custom-class="my-button"]

Parameters:

Parameter	Default	Description
gate-id	Current post ID	The gate download post ID
post-id	Current post ID	Associated release post ID
button-label	null	Custom button text
custom-class	null	Additional CSS class
download-text	null	Custom download button text

[labelgrid-gate-download-list]

Display your download gates in a grid layout.

Basic example:

[labelgrid-gate-download-list items-page="6" items-row="3"]

Parameters:

Parameter	Default	Description
show-title	false	Show gate titles
category	null	Filter by gate category
items-page	12	Items per page
items-row	4	Columns per row
pagination	null	Enable pagination
title-below	null	Position title below image

[labelgrid-gate-download-detail]

Render the full download gate detail page. This shortcode uses the current post and takes no parameters.

Example (in a gate template):

[labelgrid-gate-download-detail]

Pre-save shortcode

[labelgrid-presave-button]

Display a Spotify pre-save button for an upcoming release. Visitors can pre-save the release and optionally follow the artist and a playlist on Spotify.

Basic example:

[labelgrid-presave-button]

For a specific release:

[labelgrid-presave-button release-id="123"]

Parameters:

Parameter	Default	Description
release-id	Current post ID	The release post ID

Tip

Enable “Pre-save email collection” in the Releases settings tab to collect email addresses during the pre-save flow.

---

CSS classes reference

The plugin uses these CSS class prefixes for styling:

Class	Element
.lgsquarelist	Grid container for release and artist lists
.releaseelement	Individual release or artist card
.elementrow1 through .elementrow8	Column-specific layout (matches items-row setting)
.elementrowx	Flexible layout variant
.spotify, .twitter, .youtube, .soundcloud, .facebook	Service-specific styling on platform links
.banner-*	Release banner elements
.gate, .gateimage, .freedownload	Download gate elements

Note

The plugin does not include Gutenberg blocks, Elementor widgets, or sidebar widgets. Use shortcodes to place content in your pages and templates.

---

Troubleshooting

Releases not appearing

1. Go to Settings → LabelGrid Tools and verify your API token is entered correctly
2. Check that auto-sync is enabled in the General Options tab
3. Wait up to 6 hours for the next sync cycle, or deactivate and reactivate the plugin to trigger an immediate sync
4. Verify the releases are published in LabelGrid (not in draft status)
5. Check Settings → LabelGrid Tools → General Options and increase the debug level, then check the logs

Shortcodes showing as plain text

1. Make sure the plugin is activated in Plugins
2. Verify you are using hyphens in shortcode names (e.g., [labelgrid-release-list]), not underscores
3. Check for typos in the shortcode name

Styling issues

1. Check for CSS conflicts with your theme
2. Use your browser’s developer tools to inspect the element classes
3. Add custom CSS overrides targeting the plugin’s class names (see the CSS classes reference above)
4. Test with a default WordPress theme to isolate theme conflicts

API connection errors

1. Verify your API token is valid and not expired
2. Confirm your LabelGrid account has an active API plan
3. Check that your server can make outbound requests to gate.labelgrid.com
4. Review the plugin logs for specific error messages

Gate entries and exports

Download gate entries (email addresses collected) can be exported as CSV from the WordPress admin. Go to the gate download post and look for the export option.

---

Updates

Automatic updates

1. Go to Plugins in your WordPress admin
2. Find “LabelGrid Tools”
3. Click Enable auto-updates

Manual updates

1. Download the latest version from LabelGrid
2. Go to Plugins → Add New → Upload Plugin
3. Upload the new ZIP file
4. WordPress will prompt you to replace the existing version
5. Click Replace current with uploaded

---

Need help?

If you need assistance with the WordPress plugin, contact our support team with details about your WordPress version, PHP version, and any error messages from the plugin logs.