Skip to content
Documentation

WordPress Plugin

The LabelGrid WordPress plugin lets you easily embed your releases, smart links, and music players directly on your WordPress website. No coding required.

Overview

What You Can Do

FeatureDescription
Embed releasesDisplay album/single artwork and streaming links
Smart linksAdd customizable “listen now” buttons
Music playerEmbed audio preview players
Release feedsShow your latest releases automatically
ShortcodesSimple 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

SettingOptions
Default themeLight, Dark, Auto
Button styleRounded, Square, Pill
Show artworkYes/No
Artwork sizeSmall, Medium, Large
Platform orderDrag 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

ParameterValuesDefault
idRelease ID or UPCRequired
themelight, dark, autoauto
sizesmall, medium, largemedium
show_titleyes, noyes
show_artistyes, noyes
show_artworkyes, noyes

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"]
ParameterValuesDefault
urlYour smart link URLRequired
textButton text”Listen Now”
stylebutton, text, iconbutton
colorAny hex colorBrand color
sizesmall, medium, largemedium

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

ParameterValuesDefault
idRelease or track IDRequired
typefull, mini, artworkfull
autoplayyes, nono
show_tracklistyes, noyes
colorAny hex colorBrand 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

ParameterValuesDefault
count1-206
columns1-43
ordernewest, oldestnewest
artistArtist IDAll artists
labelLabel IDAll labels
  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:

ClassElement
.labelgrid-releaseRelease container
.labelgrid-artworkArtwork image
.labelgrid-titleRelease title
.labelgrid-artistArtist name
.labelgrid-buttonsStreaming buttons container
.labelgrid-buttonIndividual 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

BlockPurpose
LabelGrid ReleaseEmbed single release
LabelGrid Smart LinkAdd streaming button
LabelGrid PlayerEmbed audio player
LabelGrid FeedDisplay 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.