embed-usage
When to use
- YouTube/Vimeo videos — embed video content directly. Preferred over self-hosted video for long-form content.
- Interactive widgets — calculators, configurators, or other third-party tools via iframe.
- Forms — external form services embedded within the page flow.
- Maps — Google Maps or similar map embeds for location content.
Key decisions
- Embed type: Use embed-youtube or embed-vimeo for video (optimized). Use embed-iframe for everything else.
- Aspect ratio: embed-ratio-16-9 for standard video. Adjust for non-video content.
- Lazy loading: Keep enabled for performance. Critical above-fold embeds can disable.
- Accessibility: Always provide embedTitle for screen readers to describe the iframe content.
embed-options
All authoring options
Content
embedUrl: URL of external content
embedType: embed-youtube | embed-vimeo | embed-iframe
embedTitle: accessible iframe title
Layout
classes_embedAspectRatio: embed-ratio-16-9 | embed-ratio-4-3 | embed-ratio-1-1 | embed-ratio-9-16
classes_embedWidth: embed-width-full | embed-width-large | embed-width-medium
classes_embedAlign: embed-align-left | embed-align-center | embed-align-right
Behavior
classes_embedLazy: boolean (lazy load, default true)
classes_embedAutoplay: boolean (auto-play video)
Analytics
trackInview: boolean
trackInview_meta: text