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

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:
- Gallery Name – Give your gallery a descriptive name (required). This helps you organize multiple galleries.
- Description – Add an optional description for internal organization and SEO purposes.
- 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.
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
Adding Images and Videos
Schema Gallery supports both images and YouTube videos, each with comprehensive metadata fields for perfect schema markup.

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
- Select Image File – Click “Choose File” to select an image from your computer
- 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:
- Description – Detailed description of the image or video (appears in schema markup and lightbox)
- Keywords – Comma-separated keywords for organization and searchability
- Author / Organization – Credit the creator (recommended for schema validation – Google may ignore images without author information)
- License URL – Link to usage terms or license information
- Acquire License Page – URL where users can purchase usage rights
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.

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.
Saving Your Media
- Upload Image Button – Click this purple button at the bottom to save your image or video with all metadata
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.

Activation Status
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
Saving Pro Settings
After making changes to any Pro Settings:
- A blue reminder notice appears at the top: “Remember to click ‘Update Pro Settings’ below to save your changes.”
- Click the purple “Update Pro Settings” button at the bottom to save all changes
Managing Gallery Items
The Gallery Items section provides a comprehensive view of all media in your gallery with easy editing and reordering capabilities.

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

Export to CSV
Use Case: Backup your gallery data or bulk edit metadata in a spreadsheet
- Click the “Export to CSV” button in the Power Tools section
- Your browser downloads a CSV file with all gallery metadata
- Open in Excel, Google Sheets, or any spreadsheet software
Import from CSV
Use Case: Update schema metadata for multiple images at once
- Export your current gallery data to CSV (creates a backup)
- Edit the metadata fields in your spreadsheet (titles, descriptions, keywords, location data, etc.)
- Click “Import from CSV” and select your modified file
- Gallery metadata updates based on the CSV data
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
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
