Event space marketing / Matterport virtual tours / Useful guide / Virtual tours

A Complete Guide to Matterport URL Parameters

9 June 2026

Understanding Matterport URL Parameters

A Matterport URL parameter is a short piece of text you add to the end of a standard 3D Showcase link. It acts as a direct instruction for the viewer’s browser. When someone clicks your link, these parameters tell the model exactly how to load and behave.

You use them to create multiple experiences from a single 3D model. Instead of duplicating a space to make minor changes, you simply alter the web address. For example, you can take a fully branded model and add a parameter to remove all logos and contact details for a property listing site. Or, you can force a model to skip the introductory ‘dollhouse’ view and start a guided tour immediately. This helps you tailor the exact experience for different audiences without editing the original file.

Here is a complete reference list of the Matterport URL parameters and what they do

  • m: Sets the specific Matterport model ID.

  • brand: Toggles branding and contact details (0 = hide, 1 = show).

  • dh: Toggles the Dollhouse view button and intro fly-in (0 = hide, 1 = show).

  • f: Controls floor navigation (0 = lock to one floor, 1 = enable floor switching).

  • fp: Toggles the floor plan button (0 = hide, 1 = show).

  • gt: Toggles guided tour buttons (0 = hide, 1 = show).

  • help: Controls help text on load (0 = hide, 1 = full help, 2 = concise help).

  • hl: Controls the highlight reel on launch (0 = brief show, 1 = always show, 2 = keep collapsed).

  • hr: Toggles the highlight reel entirely (0 = hide, 1 = show).

  • kb: Controls panning at new highlights in tours (0 = static, 1 = gentle pan).

  • lang: Sets the interface language using standard codes (e.g., en, fr, de).

  • lp: Loops the guided tour (0 = stop at end, 1 = loop).

  • measurements: Toggles the measurement ruler icon (0 = hide, 1 = show).

  • mls: Removes branding for property listing compliance (0 = standard, 1 = MLS friendly, 2 = MLS friendly without top-left panel).

  • mt: Toggles tags (0 = hide, 1 = show).

  • nozoom: Controls zoom functionality (0 = enable zoom, 1 = disable zoom).

  • nt: Forces a new tab on mobile devices (0 = same tab, 1 = new tab).

  • pin: Toggles 360-degree view pins in Dollhouse and Floor Plan (0 = hide, 1 = show).

  • play: Starts the model automatically (0 = manual play button, 1 = auto-start).

  • portal: Toggles 360-degree connection portals in Inside View (0 = hide, 1 = show).

  • qs: Bypasses the Dollhouse fly-in for a quick start (0 = standard load, 1 = direct to Inside View).

  • search: Toggles the space search magnifying glass icon (0 = hide, 1 = show).

  • st: Sets the pause time in milliseconds at each tour highlight (Deprecated).

  • tagNav: Toggles tag navigation buttons and keyboard shortcuts (0 = hide/disable, 1 = show/enable).

  • title: Toggles the space title and top-left panel (0 = hide, 1 = show).

  • tour: Sets the default tour behaviour (0 = none, 1 = saved mode, 2 = story mode, 3 = highlight reel).

  • tourcta: Sets the end-of-tour call to action size (0 = none, 1 = large CTA, 2 = small CTA).

  • ts: Sets a delay in seconds before auto-starting a guided tour.

  • views: Toggles the Views menu (0 = hide, 1 = show).

  • vr: Toggles the Virtual Reality button (0 = hide, 1 = show).

  • wh: Controls mouse scroll wheel behaviour in iframes (0 = ignore scroll, 1 = enable scroll zoom).

  • wts: Sets the transition speed between tour highlights (Deprecated).

How to use the Matterport URL parameters

Adding a parameter to a Matterport link is straightforward. You attach the code directly to the end of your standard 3D Showcase URL.

The first parameter you add must always start with a question mark (?). If you need to stack multiple instructions together, you connect them using an ampersand (&). The order of these parameters makes no difference to how the model loads.

Here are three practical examples of how you use them for different environments.

Premium Hospitality and Event Spaces When you want to increase bookings for a high-end venue, you need to capture the client’s attention immediately. Instead of making them click through menus, you set the model to auto-play a curated highlight reel as soon as the page loads.

Standard link: https://my.matterport.com/show/?m=xxxxxxxxxxx Modified link: https://my.matterport.com/show/?m=xxxxxxxxxxx&play=1&tour=3

The &play=1 command forces the model to open automatically, and the &tour=3 command immediately launches your saved highlight reel. This creates an inviting, lifestyle-oriented experience with zero friction for the viewer.

Industrial Site Audits and Safety Training When sharing visual data of a factory floor for safety training, efficiency is the priority. You need workers to access the practical, industrial view instantly without sitting through the aesthetic ‘dollhouse’ intro. You also need to lock their view to a single floor to keep them focused on the specific training area.

Standard link: https://my.matterport.com/show/?m=xxxxxxxxxxx Modified link: https://my.matterport.com/show/?m=xxxxxxxxxxx&qs=1&f=0

The &qs=1 command enables ‘Quickstart’, bypassing the dollhouse fly-in and dropping the user straight into the inside view. The &f=0 command removes the floor selector tool, treating the model as a single, restricted level.

Unbranded Property Listings When you upload a virtual tour to an MLS property listing, strict rules require you to remove all company branding, business cards, and external links.

Standard link: https://my.matterport.com/show/?m=xxxxxxxxxxx Modified link: https://my.matterport.com/show/?m=xxxxxxxxxxx&mls=2

The &mls=2command instantly strips away all your contact details, removes the top-left ‘About’ panel, and disables external links within your tags. This delivers a completely compliant, unbranded model ready for the property portal.

Matterport 3D Tour Website Embedding (Iframes)

You do not just share these links directly. You frequently embed them into client websites using an iframe. You simply paste your modified URL into the src attribute of standard HTML code to control how the model behaves on that specific web page. <iframe width="100%" height="480" frameborder="0" allowfullscreen src="[https://my.matterport.com/show/?m=xxxxxxxxxxx&mls=2](https://my.matterport.com/show/?m=xxxxxxxxxxx&mls=2)"></iframe>

Matterport 3D Tour Default Behaviours

You only need to use a parameter when you want to change the standard experience. Every setting has a default state (usually set to ‘1’ for active). For example, you do not need to add &mt=1 to show tags, because they appear automatically. You only add the parameter to force a change, such as &mt=0 to hide them. Keeping your URLs as short as possible makes them easier to manage.

Complete Matterport Language Codes

If you use the langparameter, the interface automatically defaults to the viewer’s browser language. But if you need to force a specific language for an international client, you must use one of these exact codes:

  • en (English)

  • es (Spanish)

  • fr (French)

  • de (German)

  • ru (Russian)

  • zh (Chinese)

  • ja (Japanese)

  • ko (Korean)

  • nl (Dutch)

  • it (Italian)

  • pt (Portuguese)

Leave a Reply

EnglishenEnglishEnglish
EnglishenEnglishEnglishFrenchfrFrenchFrançais