WordPress Plugin

The LabelGrid WordPress plugin (also known as LabelGrid Gate) automatically exports and syncs your release catalog from LabelGrid to your WordPress website. LabelGrid is the source of truth — the plugin imports catalog data into WordPress automatically (twice daily), so your website always reflects your latest releases. You can also embed smart links and music players. No coding required.

Included with API plans

LabelGrid Gate is included with all API plans (Starter, Growth, Scale, and Custom API) at no additional cost.

Overview

What You Can Do

Feature	Description
Automatic catalog sync	Your release catalog is exported from LabelGrid and synced to WordPress automatically (twice daily)
Release pages	Display album/single artwork and streaming links
Smart links	Add customizable “listen now” buttons
Music player	Embed audio preview players
Release feeds	Show your latest releases automatically
Shortcodes	Simple codes to place content anywhere

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Active LabelGrid account
• API key (for advanced features)

---

Installation

From WordPress Admin

1. Go to Plugins → Add New
2. Search for “LabelGrid”
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 WordPress plugin, you need to 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’s available 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 displayed — you’ll need this for WordPress

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

WordPress Plugin Setup

1. Go to Settings → LabelGrid in your WordPress admin
2. Paste the access token you copied from LabelGrid
3. Configure default display options
4. Save changes

Display Settings

Setting	Options
Default theme	Light, Dark, Auto
Button style	Rounded, Square, Pill
Show artwork	Yes/No
Artwork size	Small, Medium, Large
Platform order	Drag to reorder

---

Embedding Releases

Using the Block Editor

1. Add a new block
2. Search for “LabelGrid Release”
3. Select the block
4. Enter your release URL or UPC
5. Customize appearance

Using Shortcodes

Basic release embed:

[labelgrid_release id="YOUR_RELEASE_ID"]

With options:

[labelgrid_release id="YOUR_RELEASE_ID" theme="dark" size="large" show_title="yes"]

Shortcode Parameters

Parameter	Values	Default
id	Release ID or UPC	Required
theme	light, dark, auto	auto
size	small, medium, large	medium
show_title	yes, no	yes
show_artist	yes, no	yes
show_artwork	yes, no	yes

---

Smart Links

Creating Smart Link Buttons

Block editor:

1. Add “LabelGrid Smart Link” block
2. Enter your smart link URL
3. Customize button text and style

Shortcode:

[labelgrid_smartlink url="https://lnk.to/your-release" text="Listen Now"]

Smart Link Options

Parameter	Values	Default
url	Your smart link URL	Required
text	Button text	”Listen Now”
style	button, text, icon	button
color	Any hex color	Brand color
size	small, medium, large	medium

Multiple Buttons

[labelgrid_smartlink url="https://lnk.to/release1" text="New Single"]
[labelgrid_smartlink url="https://lnk.to/release2" text="Latest Album"]

---

Music Player

Embedding a Player

[labelgrid_player id="YOUR_RELEASE_ID"]

Player Options

Parameter	Values	Default
id	Release or track ID	Required
type	full, mini, artwork	full
autoplay	yes, no	no
show_tracklist	yes, no	yes
color	Any hex color	Brand color

Player Types

Full Player:

• Large artwork
• Full tracklist
• Play/pause controls
• Progress bar

Mini Player:

• Compact design
• Single track display
• Basic controls

Artwork Player:

• Artwork only
• Play button overlay
• Minimal design

---

Release Feeds

Latest Releases Widget

Display your most recent releases automatically:

[labelgrid_feed count="6" columns="3"]

Feed Options

Parameter	Values	Default
count	1-20	6
columns	1-4	3
order	newest, oldest	newest
artist	Artist ID	All artists
label	Label ID	All labels

Sidebar Widget

1. Go to Appearance → Widgets
2. Add “LabelGrid Releases” widget
3. Configure display options
4. Save

---

Styling and Customization

CSS Classes

The plugin adds these classes for custom styling:

Class	Element
.labelgrid-release	Release container
.labelgrid-artwork	Artwork image
.labelgrid-title	Release title
.labelgrid-artist	Artist name
.labelgrid-buttons	Streaming buttons container
.labelgrid-button	Individual button

Custom CSS Example

.labelgrid-release {
    border-radius: 12px;
    box-shadow: 0 4px 6px rgba(0,0,0,0.1);
}

.labelgrid-button {
    font-weight: bold;
    text-transform: uppercase;
}

Theme Compatibility

The plugin works with most themes. If you experience styling issues:

1. Check for CSS conflicts
2. Try different theme setting
3. Add custom CSS overrides
4. Contact support if issues persist

---

Gutenberg Blocks

Available Blocks

Block	Purpose
LabelGrid Release	Embed single release
LabelGrid Smart Link	Add streaming button
LabelGrid Player	Embed audio player
LabelGrid Feed	Display release grid

Block Settings

Each block has a sidebar panel with:

• Content settings (ID, URL)
• Display options (size, theme)
• Style options (colors, spacing)
• Advanced options (CSS classes)

---

Elementor Integration

Using with Elementor

The plugin includes Elementor widgets:

1. Open Elementor editor
2. Search for “LabelGrid” in widgets
3. Drag widget to your page
4. Configure in the panel

Elementor Widgets

• LabelGrid Release
• LabelGrid Smart Link
• LabelGrid Player
• LabelGrid Release Grid

---

Performance

Caching

The plugin caches release data to improve performance:

• Default cache: 1 hour
• Adjustable in settings
• Clear cache manually if needed

Lazy Loading

Images load as users scroll:

• Improves page speed
• Reduces initial load
• Can be disabled in settings

CDN Support

Assets are served from CDN:

• Faster load times
• Global availability
• Automatic optimization

---

Troubleshooting

Plugin Not Working

1. Verify plugin is activated
2. Check API key is correct
3. Clear WordPress cache
4. Check for JavaScript errors
5. Try disabling other plugins

Releases Not Displaying

1. Verify release ID is correct
2. Check release is published/live
3. Ensure API key has access
4. Check browser console for errors

Styling Issues

1. Check for theme CSS conflicts
2. Try plugin’s “Reset Styles” option
3. Add custom CSS overrides
4. Test with default WordPress theme

API Connection Errors

1. Verify API key is valid
2. Check your LabelGrid account status
3. Ensure server can make external requests
4. Check firewall settings

---

Updates

Automatic Updates

Enable automatic updates:

1. Go to Plugins
2. Find LabelGrid plugin
3. Click Enable auto-updates

Manual Updates

1. Download latest version
2. Deactivate current plugin
3. Delete old plugin files
4. Install new version
5. Reactivate

Changelog

Check the plugin page or LabelGrid website for update notes and new features.

---

Need Help?

If you need assistance with the WordPress plugin, contact our support team with details about your WordPress setup.