WP Matterport Shortcode

A FREE WordPress Plugin for Embedding Matterport Showcase Spaces with full MPEmbed Support
It’s SEO friendly and spaces will launch in a distraction-free window above your site.

What is WP Matterport Shortcode?

WP Matterport Shortcode is a simple WordPress Plugin that allows you to embed Matterport Spaces 

  • Embed Matterport Spaces with preview image and an distranction-free overlay that the tour opens in.
  • Create galleries with 2, 3 or 4 columns of Matterport Spaces
  • 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.
  • Supports MPEmbed.

How do I Use WP Matterport Shortcode?

You can install WP Matterport Shortcode from the ‘Add Plugins’ page in your WordPress Admin.  Just search for ‘Matterport’.

If you would like to download it and install it manually, you can visit the WordPress.org homepage for it here:

WP Matterport Shortcode

Once installed, you can insert a Matterport space anywhere that you would like that you can write formatted text by using a shortcode.

A shortcode starts with a [ and ends with a ].  

Here’s what it looks like:

Why I Made This Plugin.

I made this plugin a few years ago for my own website.  I wanted to showcase the spaces that I had built in a very concise gallery format — just like a WordPress image gallery.  I built the code and decided it would be a great plugin to share so that everyone can build a Matterport Space Gallery on their WordPress site.

This plugin allows me to setup all of the settings that I’d like to use, specify the number of columns and  and then provide a comma separated list of spaces to instantly setup a gallery.


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" showtitle="2"]

Embed with MPEmbed Parameters:

[ matterport cols="3" src="uKDy9xrMRCi,wV4vX743ATF" qs="1" minimap="1" filter="oversaturate"]


Glossary of Parameters:

Plugin-Specific Parameters

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)


  • 1 (default) – Show tour(s) in single column
  • 2, 3, 4 – Show tour(s) in multiple columns


  • false (default) – Display tour in lightbox popup on click
  • true – Replace thumbnail with tour on click


  • 960 (default) – Thumbnails load at 960 width and display responsively
  • 640 (default for cols=2 or greater)
  • ### – Set alternate width


  • 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.


  • NULL (default) – Open tours in an overlay
  • _blank – Open tours in a blank tab/window
  • customname – Open tours in an embedded iframe by id


  • Explore 3D Space – Replace ‘Explore 3D Space’ message with custom message.


  • 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.


  • NULL (default) – Do not show address
  • 1 – Show caption beneath thumbnail with Street, City, State ZIP


  • 3 – Force Showcase 3.0 for a space that is configured to display with Showcase 2.0.  (MPEmbed also forces Showcase 3.0)


  • NULL (default) – Do not show date.
  • true – Show date of upload to my.matterport.com in caption
  • modified – Show last modified date in caption


  • NULL (default) – Do not show # of Scans
  • 1 – Show # of Scans after address in caption

Below is a list of all of the Matterport URL Parameters.  There are no surprises here.  You can use all of them with WP Matterport Shortcode.

Please refer to the ‘DOCS’ page on this site for a list of all support MPEmbed (Free) Parameters.  They are exactly the same.



  • NULL (default) – Help is shown on first visit only
  • 0 – Do not show help at all
  • 1 – Always show help when the Matterport Space opens.
  • 2 – Always show help when the Matterport Space opens. More concise help text than help=1.


  • 0 – Briefly show the highlight reel upon launch before hiding. (default if reel has no 360 views)
  • 1 – Keep the highlight reel visible upon launch. (default if reel does have 360 views)


  • 0 (default) – Show Highlight Reel
  • 1 – Hide Highlight Reel


  • 0 (default) – Disable Quickstart (when the Matterport Space first opens, zoom in from Dollhouse View)
  • 1 – Enable Quickstart (when the Matterport Space first opens, go straight into Inside View). Only works if Start Position is Inside View. Learn more.


  • -1 (default) – Number of seconds after initial fly-in before the Guided Tour automatically starts. Help is not shown. Set to a negative number to not start the Guided Tour.



  • 0 – Hide ‘Presented By’ details when Space opens. Hide contact details in the About Panel (top-left grey corner of 3D Showcase).


  • 0 – Hide Dollhouse View in introductory fly-in. Hide Dollhouse Button in bottom left corner. Hides dollhouse / floorplan view snapshots in highlight reel.


  • 0 – Hide Guided Tour buttons in the bottom left corner of the 3D Showcase UI


  • 0 – Hide Highlight Reel at the bottom of the 3D Showcase UI


  • 1 – Show the MLS-friendly version of the Matterport Space. This removes branding, removes links in Mattertag™ Posts, and removes VR.
  • 2 – Same behavior as &mls=1 but also removes the About Panel in the top-left corner after loading


  • 0 – Space title is not displayed. Top-left about panel not displayed.
  • 1 (default) – Space title is display. Top-left about panel is displayed.
  • 2 – Space title is not displayed. Top-left about panel is displayed.



  • 0 – Remove the option to switch floors. This treats the Matterport Space as “all one floor”.


  • en (default) – Shows the 3D Showcase UI in American English
  • es – Shows the 3D Showcase UI in Spanish
  • fr – Shows the 3D Showcase UI in French
  • de – Shows the 3D Showcase UI in German
  • ru – Shows the 3D Showcase UI in Russian
  • cn – Shows the 3D Showcase UI in Chinese
  • jp – Shows the 3D Showcase UI in Japanese
  • it – Shows the 3D Showcase UI in Italian (MPEmbed Only)


  • 0 – Ignore scroll wheel input from the mouse. Scroll wheel input will cause the entire webpage to move up and down. This parameter is only valid when the Space is embedded with an iframe.



  • NULL (default) – Enable zooming in 3D Showcase
  • 1 – Disable zooming in 3D Showcase


  • 2 (default – 200%) – Set maximum zoom


  • 1 (default – 100%) – Set minimum zoom


  • 1 (default) – Smooth Zoom
  • 2 – Experimental Zoom Effect



  • 0 – Do not show the path to the next highlight.
  • 1 (default) – For Guided Tours with walkthrough transitions, show the blue path on the ground to the next highlight.


  • 0 – Do not pan when you reach a new highlight in a Guided Tour.
  • 1 (default) – Gently pan once you reach a new highlight in a Guided Tour.


  • 0 (default) – Stop once you reach the end of the Guided Tour.
  • 1 – Loop back to the beginning once you reach the end.


  • 0 – For Guided Tours with walkthrough transitions, use the 3D mesh when transitioning between highlights.
  • 1 (default) – Use 2D panorama imagery during transitions (mesh-free transitions).


  • 3500 (default) – Number of milliseconds to wait at each highlight during a guided tour.


  • 0 – No call to action at the end of a a Guided Tour
  • 1 (default) – Large call to action at the end of a Guided Tour
  • 2 – Small call to action at the end of a Guided Tour



  • 0 – Hide the VR button


  • 1 – Opens the Space in a limited mode by itself. Users cannot navigate to other Spaces in the Matterport VR app. This is the same limited mode that is used in VR Collections.



  • Custom start point — hit ‘U’ while viewing a tour to get this link and copy the ‘start’ parameter.