Attributes reference

All attributes are optional except project. Attribute changes are observed live — updating one re-syncs the embed (and reloads the frame only when the underlying URL actually changes).

Content

Attribute	Values	Purpose
project (or project-id)	ID	The published project to show. Required — without it the element renders empty.
scene-id	ID	Pin a specific scene of the project.
model	path	Show a single model of the project by path.

Modes

Attribute	Values	Purpose
configurator	boolean	Enable option picking (parts & variations). Without it the embed is a viewer.
picker	off | none | false	Hide the built-in option panel while keeping the engine + SDK alive (headless).
mode	headless | launcher | ar-launcher	headless = same as picker="off". launcher = device-adaptive AR launcher page instead of the inline viewer.
launcher	boolean	Same as mode="launcher".
preview	token	Owner draft-preview token (pvexp=…&pvsig=…) so the owner can embed an unpublished project. Never set this on public pages.

Presentation

Attribute	Values	Purpose
lang (or locale)	en | tr | ru	UI language of the built-in panel and summary.
aspect	16/9, 1/1, 4/3, …	Aspect-ratio sizing (default 16/9). Accepts 16:9 too.
height	CSS length	Fixed-height sizing; overrides aspect.
loading	lazy (default) | eager	Iframe loading strategy.
allow	permissions list	Iframe permissions. Default: xr-spatial-tracking; fullscreen; camera; accelerometer; gyroscope.

Advanced

Attribute	Values	Purpose
base-url	URL	Override the viewer origin (default https://model.togenar.com).
size-hints	boolean	Append the element’s pixel size to the viewer URL. Off by default — size changes would reload the frame.
na	boolean	Skip analytics for this impression (e.g. internal dashboards).

Styling

The host element exposes one CSS custom property:

togenar-embed { --togenar-embed-bg: #f4f4f6; }   /* default: transparent */

The frame has border-radius: 12px and clips its content; wrap it if you need a different radius.