Shooting 360° photos
A good tour starts with good photos. Keep the camera at the same height in every room, use the right image size, and bracket exposures so windows and shadows both look right.
Ricoh Theta Z1
Large sensors that cope well with dim interiors. Shoot in HDR bracket mode.
Insta360 X3 / X4
High-resolution photos with built-in HDR. Quick to move from room to room.
DSLR on a panoramic head
A full-frame camera with a fisheye lens on a panoramic head, stitched afterwards. Slowest, sharpest.
Checklist
Embedding on your website
Put a tour on your own website, a developer's site or a listing portal with one snippet. It resizes to fit the page.
<div style="position: relative; width: 100%; aspect-ratio: 16/9; overflow: hidden; border-radius: 12px; background: #2C332E;">
<iframe
src="https://twin.pen.homes/tours/pen-homes-mini-office/embed?autorotate=true&speed=0.3"
title="PenTwin 360° tour"
allow="fullscreen; accelerometer; gyroscope; xr-spatial-tracking"
loading="lazy"
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: 0;"
></iframe>
</div>Permissions
For full screen, looking around by moving the phone, and VR to work inside your page, keep these in the iframe's allow attribute:
Lets visitors open the tour full screen.
Lets phone visitors look around by moving their phone.
Needed for VR on Meta Quest and Apple Vision Pro.
The tour loads only when visitors scroll to it, so your page opens faster.
Website builders
Add a Custom Code element to your section. Paste the snippet above and assign your container a relative wrapper with w-full and h-[80vh].
Use the Custom HTML Block in Gutenberg or the HTML Widget in Elementor. Paste the snippet directly.
Insert a Code Block (set Display to HTML). The tour shows once you leave the editor preview.
Paste the direct embed URL with ?brand=false into your MLS "Unbranded virtual tour" field, for portals that don't allow branding.
Embed URL Query Parameters Reference
Tailor every embedded tour experience in real time using URL search parameters. Instantly configure camera rotation velocity, gallery kiosk timeouts, atmospheric sunlight studies, and field of view.
Interactive Embed URL & Snippet Generator
Configure parameters to generate production-ready iFrames and customized embed URLs.
<div style="position: relative; width: 100%; aspect-ratio: 16/9; overflow: hidden; border-radius: 12px; background: #2C332E;">
<iframe
src="https://twin.pen.homes/tours/pen-homes-mini-office/embed"
title="PenTwin Architectural Virtual Tour"
allow="fullscreen; accelerometer; gyroscope; xr-spatial-tracking"
loading="lazy"
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: 0;"
></iframe>
</div>All options
Add to the embed URL| Parameter | Type | Default | Permitted Values | Description |
|---|---|---|---|---|
| ?scene | string | starting room | room ID | Opens the tour in this room. Each room's link, with its ID, is in the dossier's room QR codes. |
| ?autorotate | boolean | false | true, false | Slowly turns the view on its own. |
| ?speed | number | 0.3 | 0.05 – 2.0 | How fast it turns. |
| ?kiosk | boolean | false | 1, true | Opens in kiosk mode, for a screen at a show or sales office. |
| ?solar | string | tour setting | dawn, morning, midday, golden-hour, twilight, night | Starts the sun study at this time of day. |
| ?weather | string | tour setting | clear, rain, fog, snow, storm | Starts with this weather, with matching sound. |
| ?fov | number | 75 | 20 – 95 | Starting zoom, in degrees. Smaller is closer. |
| ?hud | boolean | on | 0, false | Hides the room bar, for a clean hero image on your page. |
| ?minimap | boolean | on | false | Hides the floor plan. |
| ?brand | boolean | on | false | Hides the studio badge, for portals that don't allow branding. |
| ?measurements | boolean | on | 0, false | Hides the measurements saved in the rooms. |
| ?open | string | none | sun, weather, dollhouse, audio, compare, measure, autoplay, floorplan | Opens that feature when the tour loads (if the tour allows it). |
| ?tonemapping | string | tour setting | aces, agx, neutral, reinhard, none | How bright and dark areas are balanced. Most tours look best with the default. |
Private access and webhooks
Ask visitors for their details (and an NDA if you need one) before they see a tour. Each new lead can go straight to your CRM, Slack or Discord.
How leads are sent
POST
application/json
PenTwin-Webhook/1.0
{
"event": "tour.lead.created",
"timestamp": "2026-09-24T16:00:00.000Z",
"lead": {
"id": "c9a41f3e-821b-4f9a-9e12-32a104f7b2c9",
"name": "Ama Mensah",
"email": "ama@example.com",
"phone": "+233 24 123 4567",
"company": "Mensah Family Office",
"ndaAccepted": true,
"ndaAcceptedAt": "2026-09-24T15:58:32.000Z",
"inquiryMessage": "Could we see the upper floor on a site visit?",
"preferredDate": "Tuesday at 2 pm GMT",
"source": "gate",
"sceneName": "Living room",
"metadata": {
"referrer": "https://example.com"
}
},
"tour": {
"id": "e289bf44-67a1-432d-8b0d-1c3905e3f112",
"name": "East Legon Residence",
"slug": "east-legon-residence",
"url": "https://twin.pen.homes/tours/east-legon-residence",
"studioUrl": "https://twin.pen.homes/dashboard/tours/e289bf44-67a1-432d-8b0d-1c3905e3f112"
}
}Zapier & Make (Integromat)
Create a Catch Hook in Zapier or a Custom Webhook in Make. Paste its URL into the Studio under Manage > Private access, under “Send leads to Slack, Discord or your CRM”, then click Send a test.
HubSpot and Salesforce
Use Zapier or Make in between to create a contact for each lead, with their message and preferred date.
Slack and Discord
PenTwin includes native Slack BlockKit detection. If your webhook URL contains hooks.slack.com, Paste a Slack incoming webhook or a Discord webhook URL. Each lead arrives as a short message with their details, the room and a link to the Studio.
How it works
Short animations of moving around a tour, the sun study and measuring. Press pause on any of them to stop it.
Moving around a tour
- 1Drag to look around. On a phone, swipe or move the phone; on a keyboard, use the arrow keys.
- 2Click a pin in a doorway to walk into the next room.
- 3Or pick a room on the floor plan. The cone shows which way you’re looking.
How the sun study works
- 1Set the property’s location and a date (Manage › Sun study).
- 2Set north on the floor plan, so every room knows which way it faces.
- 3Visitors pick a time. The sun moves across the sky and the patch of sunlight moves across the floor.
How measuring works
- 1Each room knows how high the camera was (Room › Lighting & detail). It’s usually about 1.5 m.
- 2Click a point on the floor. The angle down to it and the camera height give its distance.
- 3Click the bottom of a wall, then a point above it. That gives the wall’s height.
- 4Lines that don’t start on the floor are estimates, marked ≈. Check on site before you order or build.