Skip to main content

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

ParameterTypeDescription
typestring"place" or "event"
identifierstringSlug or ID of the place/event to display

Display Parameters

ParameterTypeDefaultDescription
theme / themeNamestring-Theme slug for styling
showUpdatesbooleanfalseShow offer/update badges on places
smartCropbooleantrueImageKit 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-auto in the transform (server-side smart crop).
    • Non-ImageKit URLs use CSS object-fit: cover with object-position from the stored focal point (falls back to center center).
    • Images always fill the container.
  • smartCrop=false — State 2, no smart crop:
    • ImageKit delivers native aspect ratio bytes (no h- / no fo- in the URL).
    • Normal-aspect images (ratio 0.8–2.2) use plain object-fit: cover with center center.
    • Extreme-aspect images (portrait < 0.8 or panoramic > 2.2) use contain-fit letterbox: the image is shown whole with object-fit: contain and a blurred copy fills the dead space behind it.

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.