Documentation

How to Embed & Share Your 360° Content

Integrate your virtual tours, 360° videos, and panoramas on any website or platform in minutes.

1. Quick Start: Embed with <iframe>

The simplest way to add a 360° tour or video to your site.

How to get the embed code

Go to the Publish & share tab on your media detail page.
Click Copy embed code (or choose a preset: 4K, 1080p).
Paste the code into the HTML section of your site.

Responsive embed snippet (video / panorama 360°)

Mirame360 Responsive Embed

<div style="position:relative;width:100%;max-width:1280px;padding-bottom:56.25%;height:0;overflow:hidden;">
  <iframe
    src="https://mirame360.com/embed/YOUR_VIDEO_ID"
    style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;"
    allowfullscreen loading="lazy">
  </iframe>
</div>

Responsive embed snippet (virtual tour)

Mirame360 Virtual Tour Embed

<div style="position:relative;width:100%;max-width:1280px;padding-bottom:56.25%;height:0;overflow:hidden;">
  <iframe
    src="https://mirame360.com/embed/tour/YOUR_SLUG"
    style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;"
    allowfullscreen loading="lazy">
  </iframe>
</div>

Tip: Add allow="xr-spatial-tracking; gyroscope; accelerometer" to enable motion controls on mobile devices.

2. Auto-Embed: Paste the Link (oEmbed)

Mirame360 supports the oEmbed protocol. On many platforms, just paste the direct link and the interactive player appears automatically.

Compatible platforms

Platform	Method
Notion	Paste link → auto-embed ✅
Substack	Paste link → auto-embed ✅
WordPress (core)	Paste link → auto-embed ✅
Ghost	Paste link → auto-embed ✅
Medium	Paste link (via Embedly) ✅
Slack / Discord	Rich preview with thumbnail ✅
X (Twitter)	Interactive Player Card ✅
Facebook	Rich preview with thumbnail ✅

How it works

Copy the public URL of your tour or video (e.g. https://mirame360.com/tour/my-apartment).
Paste it directly into the platform.
The platform detects oEmbed metadata and automatically generates the interactive 360° player.

💡 No code needed, no iframe — just the link.

3. Direct Links

Public URL types

Type	URL Format
Public tour	mirame360.com/tour/<slug>
Tour embed	mirame360.com/embed/tour/<slug>
Media embed (UUID)	mirame360.com/embed/<uuid>
Custom alias	mirame360.com/video/url/<alias>
User page	mirame360.com/user/<user>/media/<id>

Difference between "tour" and "embed" URLs

/tour/<slug> → full public page, optionally with a sidebar and scene list depending on tour settings.
/embed/tour/<slug> → optimized embed player for iframes — the sidebar and scene list are always hidden here, regardless of tour settings.

Custom aliases (Short URL)

You can create short, memorable URLs to share: mirame360.com/video/url/rome-apartment. Manage aliases from the Publish & share tab on any media.

⚠️ MLS Agents (USA): If your MLS requires a separate "unbranded" link for RESO compliance, check the availability of this option before publishing. 🔜 Unbranded links are not yet available — this feature is on our roadmap but has not been released.

4. QR Code

Every media item and tour has a QR code that can be generated and downloaded as a PNG directly from the dashboard.

How to download the QR code

Open your media or tour in the dashboard.
Navigate to the Publish & share section (media) or Details tab (tour).
The QR code appears at the bottom — click Download PNG.

The QR code encodes the direct link to your content and is print-ready at 1024×1024 px.

🔜 Coming soon: Printable signage generator with professional templates (Open House flyer, table tent, yard sign).

5. Customization Parameters

Embed URL query parameters

Parameter	Description
profile	Selects a specific rendition, e.g. `4k`, `1080p`, or a rendition UUID — only works if that rendition actually exists for the media. If omitted, the highest-resolution available rendition is used automatically.
width	Embed width in pixels. If omitted, the player fills 100% of its container (fluid/responsive) instead of a fixed size.
height	Embed height in pixels. If omitted, the player fills 100% of its container (fluid/responsive) instead of a fixed size.

Example with 4K quality

https://mirame360.com/embed/YOUR_ID?profile=4k&width=1920&height=1080

Tour branding settings

Tours store a few branding fields (accent_color, logo_url, embed_layout, show_scene_list, show_title_overlay) that are not part of the embed URL. The self-service editor UI for these settings is not enabled yet, so they are not something you can configure from the dashboard today.

Of these, only two actually change anything on the embedded player at /embed/tour/<slug>: show_title_overlay (shows/hides the floating title) and accent_color (colors the close button only). logo_url, embed_layout, and show_scene_list only affect the full public tour page (/tour/<slug>) — the embedded iframe always hides the sidebar/scene list regardless of these values.

ℹ️ Note: Full self-service branding controls for embeds are on our roadmap. Today these fields can only be set via support/admin.

6. Platform Guides

Method 1 — Auto-embed (recommended)

Paste the direct link into a paragraph in the Gutenberg editor. WordPress automatically detects oEmbed and renders the player.

Method 2 — Custom HTML block

Add a "Custom HTML" block.
Paste the responsive iframe snippet (section 1).
Preview and publish.

7. Troubleshooting & FAQ

❓ My embed does not load

Check that the embed toggle is on ("Make this video/image public" for media, "Embed enabled" for tours).

For oEmbed auto-embed specifically, the media must also be fully processed, approved, and marked safe — the manual iframe only requires the embed toggle to be on.

❓ oEmbed does not work on [platform]

Not all platforms support oEmbed. Use the manual iframe snippet as a fallback.

❓ The player is not responsive

Use the full responsive snippet (section 1) with the CSS wrapper: position:relative + padding-bottom.

❓ Can I remove the "By Mirame360.com" badge?

No. Whenever the embed is playable, the attribution badge is shown, regardless of your plan — there is no white-label option in the product today.

❓ The tour is password-protected — can it be embedded?

Password-protected tours cannot be auto-embedded via oEmbed for security reasons. A manual iframe will show the password entry overlay.

Need more help?

Check the full how-to guide or the FAQ page, or reach out at info.mirame360@gmail.com.