Shortcodes
This page is the reference for the two shortcodes Customer Cloud Gallery registers: the main gallery shortcode and the Pro-only print-shop shortcode. It lists every supported attribute with its default value and an example. Aimed at users who want to override layout per page or work with multiple galleries on the same site.
What you’ll learn
Section titled “What you’ll learn”- The two shortcodes the plugin registers
- Every supported attribute on
[ccgal_gallery]and what it does - How to override gallery defaults per-page without editing the gallery itself
- How to use the print-shop shortcode (Pro)
- Where to find the shortcode for your specific gallery
Prerequisites
Section titled “Prerequisites”- A published gallery — at minimum you need a gallery ID to embed (see Your first gallery)
If you’re not after an attribute reference but want a step-by-step recipe for building a gallery page (hero, title, gallery, print CTA, spacer block for transparent headers), see Building a beautiful gallery page.
[ccgal_gallery]
Section titled “[ccgal_gallery]”The main gallery shortcode. Renders the lazy-loading grid, lightbox, favorites and download UI.
Attributes
Section titled “Attributes”| Attribute | Default | Values | Description |
|---|---|---|---|
id | required | numeric WordPress post ID | The gallery post ID. Find it in Customer Cloud Gallery → All Galleries or in the URL when editing the gallery (post=42). |
per_page | gallery setting | positive integer | Override the images-per-page count for this embed. Useful if you want a denser teaser somewhere. |
load | gallery setting | scroll or button | Override the load mode. scroll = infinite scroll. button = “Load more” click. |
size | gallery setting | small, medium, large, xlarge | Thumbnail size served from the cache. large is the default for most themes; xlarge for hero galleries. |
All attributes except id are optional. Anything you don’t pass falls back to the gallery’s stored configuration.
Examples
Section titled “Examples”Minimum usage:
[ccgal_gallery id="42"]Force load-more button regardless of the gallery setting:
[ccgal_gallery id="42" load="button"]Denser teaser on a homepage block:
[ccgal_gallery id="42" per_page="12" size="medium"][ccgal_print]
Section titled “[ccgal_print]”Pro-only. Renders the print-shop checkout where visitors choose formats and paper, fill in the shipping form, and submit an order.
This shortcode is placed on a dedicated page (the plugin auto-creates one on first Pro activation, but you can move it). It reads the gallery context and the visitor’s selected images via URL parameters — visitors normally arrive here by clicking Order prints inside the gallery.
Attributes
Section titled “Attributes”The print-shop shortcode does not take attributes; it derives all context from the gallery the visitor came from. The page only needs:
[ccgal_print]Where to find your shortcode
Section titled “Where to find your shortcode”Open any gallery in the WordPress admin (Customer Cloud Gallery → All Galleries → Edit). The right-hand sidebar shows a copy-friendly box with the exact shortcode for that gallery, e.g. [ccgal_gallery id="42"].
Common mistakes
Section titled “Common mistakes”“Customer Cloud Gallery: Invalid gallery ID.”
The id you passed doesn’t match a published gallery post. Re-check the ID in the gallery list, and make sure the gallery is Published (not Draft).
The shortcode renders as plain text on the page. You’re using a page builder that strips shortcodes, or you pasted into a code-formatted block by mistake. Use a Shortcode block in the Block Editor, or the page builder’s dedicated “Shortcode” widget (Elementor, Divi and Beaver Builder all have one).
Gallery setting changed but the page still shows the old behaviour.
You’re overriding via a shortcode attribute (load= or per_page=) that wins over the gallery setting. Remove the attribute to fall back to the saved gallery configuration.
Next step
Section titled “Next step”Set up the print shop so clients can order prints directly from the gallery: Print shop setup (Pro).