Single URL Parameters
The /embed/single endpoint renders a single place or event profile page (SinglePlaceLayout or SingleEventLayout).
Base URL
/embed/single?type=<place|event>&identifier=<slug-or-id>
Required Parameters
| Parameter | Type | Description |
|---|---|---|
type | string | "place" or "event" |
identifier | string | Slug or ID of the place/event to display |
Display Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
theme / themeName | string | - | Theme slug for styling |
showUpdates | boolean | false | Show offer/update badges on places |
smartCrop | boolean | true | ImageKit AI smart crop (fo-auto) + focal point. Set false for deterministic center crop with contain-fit letterbox for extreme aspect ratios. |
smartCrop behavior
smartCrop=true(default) — State 1, the smart crop pipeline:- ImageKit URLs use
fo-autoin the transform (server-side smart crop). - Non-ImageKit URLs use CSS
object-fit: coverwithobject-positionfrom the stored focal point (falls back tocenter center). - Images always fill the container.
- ImageKit URLs use
smartCrop=false— State 2, no smart crop:- ImageKit delivers native aspect ratio bytes (no
h-/ nofo-in the URL). - Normal-aspect images (ratio 0.8–2.2) use plain
object-fit: coverwithcenter center. - Extreme-aspect images (portrait < 0.8 or panoramic > 2.2) use contain-fit letterbox: the image is shown whole with
object-fit: containand a blurred copy fills the dead space behind it.
- ImageKit delivers native aspect ratio bytes (no
Note that the site-wide hero image grid (HeroImageGrid) ignores the smartCrop prop and always cover-crops using focal point (or center). The smartCrop param affects Card, CardCarousel, and EventsGrid renderings — e.g. the similar-items carousel on the single page.