Matterport Shortcode

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)