Easily embed Matterport Spaces with preview image and a pop-up. Easily include address information and # of scans sourced directly from your Matterport tours. Optimized with information caching to make a portfolio page load fast! Includes a great admin page for refreshing cached information and quick access to your models @ MyMatterport.com.
New in v2.0 – MPEmbed.com enhancements including Minimaps, Image Enhancement Filters and deep integration of Google Analytics!
Examples
Single Tour:
[matterport src="uKDy9xrMRCi" width="900"]
Tour Gallery:
[matterport cols="3" src="uKDy9xrMRCi,wV4vX743ATF"]
Embed without Pop-Up:
[matterport embed="true" src="uKDy9xrMRCi" width="900"]
Embed with Labels:
[matterport cols="3" src="uKDy9xrMRCi,wV4vX743ATF" showdate="true" address="1" showstats="1"]
Embed with Parameters:
[matterport cols="3" src="uKDy9xrMRCi,wV4vX743ATF" qs="1" hhl="1" title="2"]
Embed with MPEmbed Parameters:
[matterport cols="3" src="uKDy9xrMRCi,wV4vX743ATF" qs="1" minimap="1" filter="oversaturate"]
Required
src (required)
- uKDy9xrMRCi – (Single Tour by ID)
- uKDy9xrMRCi,uKDy9xrMRCi,uKDy9xrMRCi – (Multiple tours by ID separated by commas)
- https://my.matterport.com/show/?m=uKDy9xrMRCi – Full URL (unnecessary, but supported)
- https://mpembed.com/show/?m=uKDy9xrMRCi – Full MPEmbed URL (if you’re using Mattertags to set options or MPEmbed Premium)
Display
cols
- 1 (default) – Show tour(s) in single column
- 2, 3, 4 – Show tour(s) in multiple columns
embed
- false (default) – Display tour in lightbox popup on click
- true – Replace thumbnail with tour on click
height
- 540 (default) – Thumbnails load at 540 height and display responsively
- 360 (default for cols=2 or greater)
- ### – Set alternate height — IT IS NOT NECESSARY TO SET BOTH WIDTH AND HEIGHT.
width
- 960 (default) – Thumbnails load at 960 width and display responsively
- 640 (default for cols=2 or greater)
- ### – Set alternate width
window
- NULL (default) – Open tours in an overlay
- _blank – Open tours in a blank tab/window
- customname – Open tours in an embedded iframe by id
Customize
address
- NULL (default) – Do not show address
- 1 – Show caption beneath thumbnail with Street, City, State ZIP
label
- NULL (default) – Source titles from Tour
- “My Tour” – Use shortcode defined title on tour
- “My Tour;My Second Tour;My Third Tour” – Use multiple titles separated by semicolons for multiple tours
- “hidden” – Do not show titles or any information below tour.
showdate
- NULL (default) – Do not show date.
- true – Show date of upload to my.matterport.com in caption
- modified – Show last modified date in caption
showstats
- NULL (default) – Do not show # of Scans
- 1 – Show # of Scans after address in caption
welcome
- Explore 3D Space – Replace ‘Explore 3D Space’ message with custom message.
Matterport Showcase Configuration Parameters
All parameters are fully supported as of 02/01/19.
Matterport URL Parameters Reference
With MPEmbed, you also can set &lang=it for the UI in Italian.
MPEmbed Premium Parameters
mpembed
- 1 – Force MPEmbed. This is only useful if you are using MPEmbed Premium or MPEmbed Hidden Settings Mattertags and are not using other parameters. Otherwise, using any of the MPEmbed parameters will automatically set this space to use MPEmbed.
mpu
- Premium User ID – Loads an MPEmbed Premium Space via your User ID
mpv
- Premium Space Version – Loads an MPEmbed Premium Space with Version #
MPEmbed (Free) Parameters
MPEmbed.com is a service created by the author of this plugin! It uses the Matterport SDK to provide new features for your Matterport Spaces.
For a list of all supported MPEmbed Parameters, please visit the MPEmbed Documentation Page:
MPEmbed Documentation
pin
- 0 – Disable 360 Placement Pins in Dollhouse / Floorplan Mode (undocumented)
portal
- 0 – Disable 360 Placement Portals in Walkthrough Mode (undocumented)