Schema Gallery Documentation

Welcome to the official Schema Gallery documentation. Here you’ll find step-by-step guides, shortcode examples, feature explanations, and screenshots to help you get the most out of your gallery plugin.

Getting Started

Welcome to Schema Gallery! This guide will walk you through everything you need to know to create beautiful, SEO-optimized galleries with validated JSON-LD structured data.

What Makes Schema Gallery Different?Schema Gallery is a WordPress gallery plugin that provides zero-error schema validation for both ImageObject and VideoObject markup, verified against Google’s Rich Results Test and Schema.org validators.

Quick Start Guide

Install the Plugin

Download Schema Gallery from the WordPress plugin repository or upload it directly from your WordPress admin panel.

Create Your First Gallery

Navigate to Schema Gallery in your WordPress admin menu and click “Add New” to create your first gallery.

Add Images or Videos

Upload images or add YouTube videos with all the metadata needed for perfect schema markup.

Use the Shortcode

Copy the gallery shortcode and paste it into any post, page, or widget to display your gallery.

Dashboard Overview

The Schema Gallery dashboard is your central hub for managing all your galleries and accessing key features.

Dashboard
Schema Gallery Dashboard

Dashboard Statistics

Total Galleries

Quick count of all your created galleries

Total Images

Count of all images across all galleries

Pro Status

Your license status and activation state

Gallery Management Table

Your galleries are displayed in a clean table with the following columns:

Column Description
ID Unique gallery identifier
Name Gallery name (clickable to edit)
Shortcode Ready-to-copy shortcode with one-click copy button
Created Date and time the gallery was created
Actions Edit, Duplicate, or Delete buttons

Resources & Help

At the bottom of your dashboard, you’ll find quick access to:

  • Documentation – Comprehensive guides and tutorials
  • Pro Features – Discover advanced capabilities
  • Pro Version – Manage account, support, and feedback

Creating Your First Gallery

Creating a gallery in Schema Gallery is quick and straightforward. Follow these steps to get your first gallery up and running.

Gallery Creation
Gallery Creation Screen

Step-by-Step Process

1. Start a New Gallery

From your dashboard, click the “Add New” button. You’ll be taken to the gallery creation screen.

2. Configure Basic Gallery Settings

At the top of the screen, you’ll see three essential fields:

  1. Gallery Name – Give your gallery a descriptive name (required). This helps you organize multiple galleries.
  2. Description – Add an optional description for internal organization and SEO purposes.
  3. Default Sort Order – Choose how images display by default:
    • Newest → Oldest (default)
    • Oldest → Newest
    • Custom Order (Pro feature – requires Enable Custom Sort in Pro Settings)

3. Save Your Gallery Information

Click the “Update Gallery Info” button (located to the right of the Default Sort Order field) to save your changes.

ImportantYou must save your gallery information before you can add images or configure Pro Settings. The gallery ID is generated when you first save.

4. Next Steps

After saving your gallery information, you can:

  • Add images or YouTube videos
  • Configure Pro Settings for advanced layouts and features
  • Manage and reorder gallery items
  • Copy your shortcode to display the gallery
Pro TipConfigure your Pro Settings before adding lots of images. This lets you set your preferred layout style and see how your gallery will look as you add content.

Adding Images and Videos

Schema Gallery supports both images and YouTube videos, each with comprehensive metadata fields for perfect schema markup.

Add Media Interface
Add Media Interface

Upload Images or Add Videos

The “Upload Image or Video” section provides two options via radio buttons:

  • Upload Image – Select and upload an image file from your computer
  • Add YouTube Video – Enter a YouTube URL to embed a video

For Images: Required Fields

  1. Select Image File – Click “Choose File” to select an image from your computer
  2. Title / Name – Enter a descriptive title (becomes the image alt text and appears in schema markup)

For YouTube Videos(Pro Feature)

When “Add YouTube Video” is selected, you’ll enter the YouTube URL instead of choosing a file. All other metadata fields work the same way.

Optional Metadata Fields

These fields enhance your schema markup and improve SEO:

  1. Description – Detailed description of the image or video (appears in schema markup and lightbox)
  2. Keywords – Comma-separated keywords for organization and searchability
  3. Author / Organization – Credit the creator (recommended for schema validation – Google may ignore images without author information)
  4. License URL – Link to usage terms or license information
  5. Acquire License Page – URL where users can purchase usage rights
Schema Best PracticeWhile schema.org considers the Author field optional, Google’s Rich Results Test may ignore images that don’t include author information. We recommend filling this field for best SEO results.

Location Information (Pro Feature)

Below the standard metadata fields, you’ll find the Location Information section. Click to expand this section and add geographic data to your images.

Location Fields
Location Information Fields

Geographic Fields

Add location data that will be included in your schema markup:

  • Location Name – Descriptive name (e.g., “Downtown Phoenix”, “Grand Canyon”)
  • Address – Full street address (optional)
  • Latitude – Decimal degrees (e.g., 33.4484)
  • Longitude – Decimal degrees (e.g., -112.0740)

After entering location data, click the “Add Video” button (or “Upload Image” if adding an image) to save the item with location information.

Pro FeatureLocation schema markup must be enabled in Pro Settings for this data to appear in your structured data. See the Pro Settings section for details.

Saving Your Media

  1. Upload Image Button – Click this purple button at the bottom to save your image or video with all metadata
Schema ValidationAll metadata you enter is automatically converted to validated JSON-LD structured data that passes Google’s Rich Results Test with zero errors.

Pro Settings Configuration

Pro Settings unlock advanced features and customization options. These settings apply per-gallery, giving you complete control over each gallery’s appearance and behavior.

Pro Settings Panel
Pro Settings Panel

Activation Status

Pro Settings (Unlocked)When your license is active, you’ll see a green banner at the top showing “Your license is active. Enjoy all premium features.”

Display Settings

Control the basic display properties of your gallery:

Setting Options Default
Images per Page 1-200 16
Gallery Display Style Clean Grid (Default), Masonry, Carousel, Compact Clean Grid
Gallery Columns 1, 2, 3, 4, 5, or Compact Style 5

Visual Customization Toggles

Each toggle switch controls a specific visual aspect. Toggle switches show green when enabled:

Border Thumbnail Radius

Enable rounded corners on thumbnails for a modern look

Toggle Thumbnail Dropshadow

Toggle the drop shadow effect on or off

Enable Custom Sort

Enable drag-and-drop manual sorting in the Gallery Items section

Toggle Thumbnail Border

Toggle the 1px white border on or off for each image

Toggle Thumbnail Border Color

Toggle the border color from white to black

Show Title on Thumbnails

Display title overlay on gallery thumbnails

Show Title in Lightbox

Display image title when viewing in lightbox

Show Caption in Lightbox

Show image description when viewing in lightbox

Show Image Counter

Display image counter (e.g., “4 of 12”) in the lightbox

Enable Location Schema

Activate geographic location data in your schema markup. Must be enabled for location information to appear in structured data.

Remove “Powered By” Link

Remove the “Powered by Schema Gallery” attribution link from this gallery

Custom Sort Behavior

When Enable Custom Sort is toggled on:

  • The Gallery Items section becomes sortable with drag handles (≡) appearing on each item
  • You can drag items to reorder them manually
  • Auto-Save: Order changes save automatically – no button to click!
  • Your custom order overrides the Default Sort Order setting
  • Especially useful for Masonry layouts where you want precise control over visual flow
Auto-Save FeatureWhen reordering items in Custom Sort mode, your changes save automatically as soon as you drop an item in its new position. There’s no save button to click – just drag and drop!

Saving Pro Settings

After making changes to any Pro Settings:

  1. A blue reminder notice appears at the top: “Remember to click ‘Update Pro Settings’ below to save your changes.”
  2. Click the purple “Update Pro Settings” button at the bottom to save all changes
Remember to Save!Pro Settings changes are not applied until you click “Update Pro Settings”. The reminder notice will stay visible until you save.

Managing Gallery Items

The Gallery Items section provides a comprehensive view of all media in your gallery with easy editing and reordering capabilities.

Gallery Items Management
Gallery Items Management

Items Table Overview

Your gallery items are displayed in a table with:

  • Drag Handle (≡) – Appears when Custom Sort is enabled for reordering
  • TYPE – Icon showing image or video
  • PREVIEW – Thumbnail of the media
  • TITLE – Name and description
  • URL – Full path to the media file or YouTube URL
  • ACTIONS – Edit or Delete buttons

Drag-and-Drop Reordering

When Custom Sort is enabled in Pro Settings, drag handles (≡) appear on the left side of each item:

1. Enable Custom Sort

Toggle on “Enable Custom Sort” in the Pro Settings panel and click “Update Pro Settings”

2. Grab the Handle

Click and hold the drag handle (≡) on the left side of any item

3. Drag to Position

Move the item up or down to your desired position

4. Auto-Save

Release to drop in place. Your new order saves automatically – no button to click!

Masonry Layout TipCustom sorting is especially powerful with Masonry layouts. Arrange your images to create the perfect visual flow and storytelling sequence.

Editing and Deleting Items

Each item has two action buttons:

  • Edit – Opens the item’s metadata for editing (same fields as when adding)
  • Delete – Permanently removes the item from the gallery

Import & Export Tools

Power tools for bulk editing schema metadata. Perfect for agencies managing large sites or updating metadata across many images at once.

Import & Export Tools
Import & Export Section

Export to CSV

Use Case: Backup your gallery data or bulk edit metadata in a spreadsheet

  1. Click the “Export to CSV” button in the Power Tools section
  2. Your browser downloads a CSV file with all gallery metadata
  3. Open in Excel, Google Sheets, or any spreadsheet software

Import from CSV

Use Case: Update schema metadata for multiple images at once

  1. Export your current gallery data to CSV (creates a backup)
  2. Edit the metadata fields in your spreadsheet (titles, descriptions, keywords, location data, etc.)
  3. Click “Import from CSV” and select your modified file
  4. Gallery metadata updates based on the CSV data
Important NoteImport/Export is designed for bulk editing schema metadata within Schema Gallery only. It cannot be used to import galleries from other plugins.
Critical WarningBack up your database before importing. Do not modify image/video file paths in the CSV. Changing file paths can break your gallery.

Download Template

Click “Download Template” to get a blank CSV template showing the proper format and all available fields. This is the easiest way to understand the structure before creating your own import file.

Best Practices

  • Always export before importing to have a backup
  • Test imports on a staging site first
  • Keep your CSV files organized with version numbers
  • Don’t change existing file paths
  • Use the template as a reference for field names and format

Using Shortcodes

Every gallery gets a unique shortcode for easy embedding anywhere on your WordPress site.

Your Gallery Shortcode

On the dashboard, each gallery displays its shortcode:

[schema_gallery id="1"]

The number is your gallery’s unique ID.

Quick Copy

Click the “Copy” button next to any shortcode to instantly copy it to your clipboard.

Where to Use Shortcodes

  • WordPress posts and pages (Gutenberg or Classic Editor)
  • Text widgets in sidebars or footers
  • Page builder elements (Divi, Elementor, Beaver Builder)
  • Template files using do_shortcode()

Universal Compatibility

WordPress Core

Works with Gutenberg and Classic Editor out of the box

Page Builders

Full compatibility with Divi, Elementor, and more

Any Theme

Universal shortcodes work with properly coded themes

Automatic Schema MarkupWhen you use a shortcode, the gallery displays with all your configured settings and validated structured data automatically applied. No additional configuration needed!

Frequently Asked Questions

Do I need Pro for basic galleries?

No! The free version supports unlimited galleries and images with full schema markup. Pro adds advanced features like location schema, custom layouts, and additional customization options.

What structured data does Schema Gallery provide?

Schema Gallery generates validated JSON-LD markup for:

  • ImageObject – For all images
  • VideoObject – For YouTube videos
  • Place/Location data – Pro feature for geographic information

All markup is validated to pass Google’s Rich Results Test with zero errors.

What is the Import/Export feature for?

The Import/Export tools are designed for bulk editing schema metadata within Schema Gallery. You can export your gallery data to CSV, edit metadata fields like titles, descriptions, keywords, and location data in a spreadsheet, then import the changes back. This is perfect for updating large galleries efficiently.

How does Custom Sort work?

When you enable Custom Sort in Pro Settings, drag handles appear on each gallery item. You can click and drag items to reorder them. The best part: changes save automatically when you drop an item in its new position – no save button needed!

Does this work with my theme?

Yes! Schema Gallery uses universal WordPress shortcodes that work with any properly coded theme and all major page builders including Divi, Elementor, and Beaver Builder.

How does Schema Gallery help with SEO?

Schema Gallery provides validated structured data that helps search engines understand your images and videos. Benefits include:

  • Rich results in Google search
  • Better image search rankings
  • Enhanced discoverability by AI search engines
  • Improved click-through rates from search
  • Location-based search optimization (Pro feature)

Can I use Schema Gallery on multiple sites?

The free version can be used on unlimited sites. Pro licenses are available for:

  • Pro: 1 site ($69/year)
  • Freelancers: 5 sites ($129/year)
  • Developers: Unlimited sites ($199/year)

What makes Schema Gallery different from other gallery plugins?

Schema Gallery is a WordPress gallery plugin that provides zero-error schema validation verified against Google’s Rich Results Test for both video and images mixed on a page. While other gallery plugins may add some schema markup, Schema Gallery is built specifically for perfect structured data implementation.

Support & Resources

Getting Help

We’re here to help you succeed with Schema Gallery:

  • Documentation – This comprehensive guide
  • Support Forum – Community support for free users (coming soon)
  • Priority Support – Direct email support for Pro users
  • Suggestions – Share your feature ideas with us

Upgrade to Pro

Unlock all features including:

Location Schema

Add geographic data to your images

4 Gallery Layouts

Clean Grid, Masonry, Carousel, Compact

Custom Sorting

Drag-and-drop image reordering with auto-save

Priority Support

Direct email support from our team

[schema_gallery id=”1″]