3D Gallery Builder

Turn any flat image into a 3D artwork you can preview on screen and place on a wall in Augmented Reality. The 3D Gallery Builder generates a dynamic 3D model from a JPG or PNG complete with optional mount or frame – so visitors can see how art, photos, or prints look in real space.

The ‘ar-gallery’ shortcode is the simplest way to embed a gallery model on any page or post.

Dimensions:

How it works

  1. Image source — Uses the featured image of the current page/post, or a custom URL you provide.
  2. 3D model generation — The plugin builds a glTF model on the fly via the gallery endpoint, wrapping your image in the chosen aspect ratio and frame style.
  3. Interactive viewer — Visitors can rotate and zoom the artwork in 3D, switch print sizes (unless hidden), and launch View in AR to hang it on a wall.

Gallery models default to wall placement in AR, which suits framed artwork and photos.

Basic usage

Shortcodes are to be surrounded with square brackets.

Use the page’s featured image:

ar-gallery

Set a featured image on the page first. The shortcode reads its dimensions to pick the closest aspect ratio automatically.

Use a specific image URL:

ar-gallery image_url=”https://yoursite.com/wp-content/uploads/artwork.jpg”

Full example:

ar-gallery image_url=”https://example.com/image.jpg” ratio=”2:3″ orientation=”landscape” size=”2″ hide=”size”
See it in Action

Shortcode options reference

AttributeValuesDefaultDescription
image_url
Any valid image URL
Featured image of current post
Image to display. Aliases: image, url.
ratio
1:1, A4, A4-A1, 2:3, 4:5, 3:4, 3:1
Auto-detected from image dimensions
Forces the frame aspect ratio. Also accepts numeric keys like 1.0, 1.4142, 1.5, 1.25, 1.33, 3.1.
orientation
landscape, portrait, square
Auto-detected from image
Controls frame orientation. Short forms l, p, and s also work.
scale
Numeric scale ID (e.g. 1, 1.5, 2, 2.5, 3)
First available size for the ratio
A scaling multiple for the base size of the chosen ratio. e.g. Ratio 4:5 has a base size of 8″×10″, which a scale of 1.5 the model will display at 12″x15″, scale of 2 it will display at 16″x20″
hide
size
—
Hides the on-screen Gallery Size Selector dropdown. Use hide="size" for a fixed-size display.

Frame, color & opacity

AttributeValuesDefaultDescription
frame
none, mounted, framed
From product/post meta
none = image only; mounted = mounted look; framed = full picture frame.
color
Hex color (e.g. #f8f8f8 or f8f8f8)
From product/post meta
Mount/frame color.
opacity
0.0 to 1.0
1.0
Mount/frame opacity. 1.0 = solid; lower values = more transparent.

Example:

ar-gallery frame=”framed” color=”#2c2c2c” opacity=”1.0″ ratio=”4:5″ size=”2″

Aspect ratios explained

Shortcode valueLabelTypical use
1:1
Square
Instagram-style art, album covers
A4 / A4-A1
ISO paper sizes
Posters, prints, standard documents
2:3
2:3
Classic photo print ratio
4:5
4:5
Portrait photography, social crops
3:4
3:4
Common portrait orientation
3:1
3:1 Panorama
Wide panoramic prints

If you omit ratio, the plugin calculates the closest match from the image’s pixel dimensions. If you set ratio or orientation, that choice is locked and won’t change when the image loads.

Print sizes

Available sizes depend on the aspect ratio. Examples from the built-in catalog:

1:1 (Square) — 8×8 in through 36×36 in
A4–A1 — A4, A3, A2, A1 paper sizes
2:3 — 8×12 in through 30×48 in
4:5 — 8×10 in through 30×24 in
3:4 — 9×12 in through 18×24 in
3:1 (Panorama) — 5×15 in through 20×60 in

The size dropdown shows human-readable labels (cm and inches). Use the scale attribute to aopply a custom scale; use hide="size" to hide the selector entirely.

Which ratios and sizes appear can be limited under AR Settings → AR Gallery.

Frame types

When frame options are available (via WooCommerce shortcode attributes or the model editor’s 3D Gallery Builder tab):

  • None — Artwork only, no mount or frame geometry.
  • Mounted — Mounted presentation with customizable color and opacity.
  • Framed — Full picture-frame style for a traditional gallery look.

Frame color accepts hex values. Opacity runs from 0.0 (fully transparent) to 1.0 (fully opaque).

Examples

Example 1 – Auto-detected ratio (featured image)

Shortcode: ar-gallery

Dimensions:

Example 2 – 2:3 landscape, framed

Shortcode: ar-gallery  ratio=”2:3″ orientation=”landscape” frame=”framed” color=”#333333″

Dimensions:

Example 3 – 1:1 square, mounted, fixed size

Shortcode: ar-gallery image_url=”YOUR_IMAGE_URL_HERE” ratio=”1:1″ orientation=”square” frame=”mounted” color=”#f8f8f8″ scale=”4″ hide=”size”

Dimensions:

Example 4 – 3:1 panorama, fixed size, framed

Shortcode: ar-gallery image_url=”YOUR_IMAGE_URL_HERE” ratio=”3:1″ orientation=”landscape” scale=”2″ frame=”framed” color=”#000000″

Dimensions: