Shortcode reference

Embed an interactive image with [pixmapr id="123"]. Every attribute is optional; anything you leave out uses the setting saved on the image itself, so the same image can appear differently on different pages.

[pixmapr id="12" layout="lightbox" align="center" max_width="900px" caption="Our showroom"]

Display

Attribute	Values	What it does
id	image ID	Which interactive image to show. Defaults to the most recent one.
layout	left, right, top, bottom, lightbox, tooltip	Where hotspot content appears.
trigger	click, hover	What opens a hotspot.
always_visible	yes, no	Keeps hotspots highlighted at rest.
theme	theme name	Applies a saved theme’s colors to this placement only.
align	left, center, right, wide, full	Alignment of the image block.
max_width	e.g. 800px, 60rem, 100%	Caps the width. A bare number means pixels.
class	CSS classes	Extra classes on the wrapper.
caption	text	Caption beneath the image.
show_title	yes, no	Shows or hides the heading inside information boxes.
hotspots	e.g. 1,3 or ikebukuro	Shows only these hotspots, by position or title.
exclude	same format	Hides these hotspots.
alt	text	Alternative text for the image.

Markers and legend

Attribute	Values	What it does
markers	none, dot, number, pin, tag	Puts a visible marker on every hotspot. tag is the pulsing product-tag dot.
marker_color	hex color	Marker color, e.g. #ffd957.
marker_size	12 to 72	Marker diameter in pixels.
legend	none, below, left, right	Shows a list of every hotspot alongside the image.
legend_style	text, products	products turns the legend into a shop-this-image strip.

Zoom and fullscreen

Attribute	Values	What it does
zoom	yes, no	Pan and zoom. Zoom with Ctrl (or Cmd) + scroll; the page scroll is never captured.
fullscreen	yes, no	Overrides the image’s own setting and the site default.
fullscreen_layout	side, overlay, stacked	Information box position while fullscreen on a large screen.
fullscreen_layout_mobile	sheet, stacked, overlay	The same for phones and narrow windows.

Performance

Attribute	Values	What it does
lazy	yes, no	Overrides the global lazy-loading setting.
size	a registered image size, e.g. large	Which image size to serve. Hotspots stay aligned at any size.
mobile_list	yes, no	The tappable hotspot list on small screens.

Shop cards

Attribute	Values	What it does
shop_layout	card, compact, overlay, minimal	Which ready-made look a tagged product uses.
shop_accent	hex color	Accent for the card’s button and sale price.
shop_button_style	solid, outline	Button style.
shop_corners	rounded, soft, square	Corner treatment.
shop_price, shop_rating, shop_excerpt, shop_badge	yes, no	Whether each part of the card appears.