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 @

New in v2.0 – enhancements including Minimaps, Image Enhancement Filters and deep integration of Google Analytics!


Tour único:

[matterport src="uKDy9xrMRCi" width="900"]

Galeria de tours:

[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"]


src (obrigatório)

  • uKDy9xrMRCi – (tour único pelo ID)
  • uKDy9xrMRCi,uKDy9xrMRCi,uKDy9xrMRCi – (Multiple tours by ID separated by commas)
  • – Full URL (unnecessary, but supported)
  • – Full MPEmbed URL (if you’re using Mattertags to set options or MPEmbed Premium)



  • 1 (padrão) – Mostrar tour(s) numa única coluna
  • 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


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


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


  • NULL (default) – Open tours in an overlay
  • _blank – Open tours in a blank tab/window
  • customname – Tours abertos num iframe incorporado por id



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


  • 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 date.
  • true – Show date of upload to in caption
  • modified – Show last modified date in caption


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


  • 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


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


  • Premium User ID – Loads an MPEmbed Premium Space via your User ID


  • Premium Space Version – Loads an MPEmbed Premium Space with Version #

MPEmbed (Free) Parameters 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


  • 0 – Disable 360 Placement Pins in Dollhouse / Floorplan Mode (undocumented)


  • 0 – Disable 360 Placement Portals in Walkthrough Mode (undocumented)

Imagens de tela

  • Sample Output.
  • Sample of Shortcode in Editor.


  1. Upload the plugin files to the /wp-content/plugins/wp-matterport-shortcode directory, or install the plugin
    through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the [matterport] shortcode within any post or page on your site!


Q: Eu mudei o título do meu tour no, mas isso não muda no meu site!

A: Visit Admin > Settings > WP Matterport Shortcode to refresh!

Q: What is

A: MPEmbed is an enhancement for Matterport Spaces that serves as an overlay that uses the Showcase SDK to add new features. It’s another project by the author of this WordPress Plugin!

Q: How do I use MPEmbed with WP Matterport Shortcode

A: It’s easy! If you use any parameters that require MPEmbed, your tour will automatically load via MPEmbed!

Q: Does WP Matterport Shortcode support MPEmbed Premium?

A: Yes, simply use a full MPEmbed URL in the ‘src’ parameter.

Q: Eu amo a sobreposição de lightbox.

A: Thanks, it’s Magnific Popup by Dmitry Semenov. Go check out his site. He makes some awesome stuff!

P: Eu já estou usando Magnific Popup no meu site e este plugin está causando problemas.

A: wp_dequeue_script(‘magnific’); wp_dequeue_style(‘magnific’);

Q: Can you add features?

A: For suggestions or inquiries, email


12 outubro, 2021
Very much like this plugin but wordpress is complaining that it hasn’t been tested recently. Warning: This plugin has not been tested with your current version of WordPress. Can you respond?
19 abril, 2017
This plugin is exactly what I needed to display my Matterport tours on my clients websites. It is very clean and efficient. I would highly recommend this plugin to showcase your tours.
Leia todas as 9 avaliações

Colaboradores e desenvolvedores

“Matterport Shortcode” é um software com código aberto. As seguintes pessoas contribuíram para este plugin.


Registro de alterações


  • Bug fix for multi columns


  • Added fixes to escape variable outputs
  • Replaced cURL call with wp_remote_get
  • Several minor fixes


  • Added fix for Cross Site Request Forgery (CSRF) vulnerability using nonces


  • Added fix for crashes in plugin admin
  • Added fix for Cross Site Request Forgery (CSRF) vulnerability


  • Added fix for ‘src’ Cross Site Scripting (XSS) vulnerability


  • Bug fix for embed parameter


  • Added fix for Cross Site Scripting (XSS) vulnerability


  • Added fix for ‘src’ Cross Site Scripting (XSS) vulnerability
  • Added fix for broken thumbnail


  • Added fix for ‘mpv’ (MPEmbed Version ID)
  • Added url encoding for image, logo, bgmusic, minimapurl
  • Added MPEmbed parameter support for compactdetails, openmt, bgmusicpaused, bgmusicpauseonmedia


  • Resolved Admin Bug


  • Resolved potential conflict with other plugins over a generic function name


  • Added fix for ‘mpu’ (MPEmbed User ID)


  • Added &showcase_version to force Showcase 3
  • Added support for new Showcase 3.0.6 params: portal, pin
  • Added support for MPEmbed Premium (mpv, mpu)
  • Added support for all published MPEmbed (Free) parameters (


  • “welcome” parameter now works. Thanks marchettia


  • Resolved error notices for tours without certain portions of addresses being available.


  • Fixed – Seems all spaces were running through MPEmbed. Not the worst idea in the world, but not what I was hoping to achieve.


  • Adds support for
  • Adds MPEmbed parameter support for info, details, mdir, mdirsearch, mt, hdir, logo, image, reels, nofade, ga, minimap, minimapurl, minimapfilter, fadehotspots, hotspots, filter, copyright, tint, c


Fixed CSS that added a small black line below tours without labels.


Add welcome= parameter. Replace ‘Explore 3D Space’ with a custom message. (Replace spaces with %20)


  • Fixed tiny bug where embedded galleries with multiple manually set titles were only displaying the first title.


  • Added ‘embed=true’ parameter to enable displaying Matterport Tour in place (without an overlay)


  • Added formatted error messages when an invalid, or private tour is embedded.
  • Fixed ts=# parameter


  • Fixed a few PHP Notice Messages.


  • Added ‘allow=”vr”‘ parameter to IFRAME to allow WebVR support for Chrome v62+ on mobile. This only affects tablets as default behavior on small screens is to open in a new window.


  • Swapped for Matterport CDN with Image Resizing (new!)
  • Added Params: width, height (default 940, 540)
  • Removed Param: nocache
  • Fixed PHP Warnings related to &title


  • Added Params: dh, gt, hr, mt, title
  • &mls=2 now supported
  • Changed plugin-specific use of ‘title’ param to ‘label’
  • Legacy use of ‘title’ to label tours still supported if non-numeric


  • Plugin name changed to: WP Matterport Shortcode (was: WP Matterport Shortcode Gallery Embed)
  • Updated Banner, Icons, and Admin Icon
  • Removed unused VR icons.


  • &lang – Now accepts any parameters (previous es, fr only)
  • Fixed z-index conflicts with sticky menu themes with z-index: 999


  • Fixed window parameter again… sorry, seems like the overlay broke.


  • Fixed mls and title parameters
  • Fixed ‘undefined variable’ bug when clearing admin cache.


  • Added ‘nocache’ parameter to bypass image caching for when you change the default thumbnail and it won’t refresh.


  • Fixed window parameter… because coding and not testing is stupid.


  • Added ‘window’ parameter to allow users to open tours in a new window or existing embedded iframe


  • Faster loading images fixed. Found a much easier method to seve from


  • Faster loading images — LINUX INSTALLS ONLY
  • Now uses for image resizing and caching — LINUX APACHE ONLY


  • Now supports all parameters from
  • Added hhl, minzoom, maxzoom and zoomtrans
  • Removed ‘unbranded’ parameter. Please use ‘brand’
  • Removed ‘floors’ parameter. Please use ‘f’


  • Adicionado ‘lang’ parâmetro


  • Parâmetro ‘nozoom’ adicionado
  • Removed ‘VR Ready’ Tag as all tours contain CoreVR
  • Fixed ‘start’ parameter and limited to only work on single tour embeds.


  • Fixed bug that was showing all tours unbranded. Sorry about that.


  • Fixed errors when displaying addresses
  • Added QuickStart parameter (qs=1)
  • Removed floors parameter
  • Removed OpenGraph code (unnecessary)
  • Parâmetro sem marca alterado para marca


  • Fixed error message caused by meta data change to address.


  • Forced use of OpenMetaGraph tags for images after plugin broke.


  • Tour will skip Lightbox when window is < 600px. (mobile)


  • Fixed non-dollhouse thumbnail generation (broken in 1.4.3)


  • Added support for showing default generated dollhouse thumbnail


  • Added !important to lightbox max-width 1200px


  • ‘VR Ready’ status appears on tours enhanced for Samsung VR
  • Added showdate parameter (false/true/modified)
  • Admin – Cached Tour Information displays by date created
  • FIX – Duplicate database entries no longer generated on tours with short titles.


  • WPMS now saves and retrieves cached data to custom database table – wpms
  • Admin – Moved to Top Level with a recognizable icon
  • Admin – Plugins Page – Added Link to ‘Settings / Cache Management’
  • Admin – Added Screen Options – Columns 1,2,3,4 for fun!
  • CSS Fix: Forced ‘clear: both’ to new rows in 2, 3 and 4 column layouts


  • Added title=”hidden” option to hide title area.


  • Added WP Matterport Shortcode Admin Page
  • Added ability to refresh data via Admin
  • Added ability to quickly access model on via Admin
  • Removed expiration on cached data.
  • Fixed address=”true” parameter. Addresses now display.
  • Added margin-bottom: 0 to .wpm img — to override themes adding space below image.


  • Automatically enqueues jQuery if not included by theme.
  • Separated Magnific Pop-Up Javascript/CSS, enqueued as ‘magnific’ – so that it can be disabled via theme — if perhaps one uses WF Magnific or IW Magnific plugins.
  • Changed line-height to 56px for Arrow — tnx IBAdvantage


  • Title and Image URL cached as transients – much faster!
  • Added address option: address=TRUE to show street/city/state/zip
  • Added showStats option: showStats=TRUE to show XXX Scans
  • Fixed source image sizes to 960 width in 1 Column Mode; 640×320 for 2 and higher.
  • Added retrieval of Title/Address/# va JSON with OpenGraph fallback
  • Changed CSS prefix to wpm- as a universal prefix.
  • Updated MagnificPopup to v1.1.0


  • Featured: Added title parameter. Add a title from the shortcode to single or multiple tours (separate with semi-colon)
  • Feature: Added Spanish, French and German internationalization of the ONE line of text — Explore 3D Space


  • Feature: Added class – ‘wpm[matterport ID]’ to containers
  • Fix: Internet Explorer – Fixed thumbnails by disabling use of Google Image Cache in IE.
  • Fix: Added 1em of space below each tour when columns become 100% width (< 740px)
  • Optimization: Thumbnail image size set to 600 if using columns (Instead of 900)


  • Added floors, guides help and start parameters.
  • Added 1em of margin below shortcode output.


  • Lançamento inicial.