---
title: Matterport 3D tour button in photo gallery
description: "You can add a 3D tour button to the property photo gallery so guests can open each listing's tour. **Requirements.** You need HomeRunner Toolkit version…"
url: "https://homerunner.io/docs/how-do-i-show-a-matterport-3d-tour-button-in-the-property-photo-gallery/"
updated: "2026-10-26"
category: Setup and plugins
---

# Matterport 3D tour button in photo gallery

You can add a 3D tour button to the property photo gallery so guests can open each listing's tour.

**Requirements.** You need HomeRunner Toolkit version 3.319.1 or later with the Photo Gallery module enabled.

**Setting it up.** Follow these steps in WordPress:

1. Go to **HomeRunner > Toolkit > Photo Gallery** and find the 3D tour section.
2. In the **3D tour field** setting, enter the name of the custom field that holds each listing's tour URL or ID. Use the name exactly as it appears in your PMS (for example "matterport"), or a WordPress custom field key.
3. For **Open the tour in**, choose one of three options. **A modal** opens the tour over the page. **A full-screen modal** fills the entire window. **A new tab** works best for tour providers that do not allow embedding.
4. Optionally, set a custom **Button text**. If you leave it empty, the button text defaults to "3D Tour".
5. Optionally, use the **Button style** options to set background, text, and outline colors plus corner radius.

The preview at the top of the panel reflects your changes.

**Accepted formats.** The 3D tour field accepts any of these formats: a Matterport model ID (for example "SxQL3iGyoDo"), the link's "m=" parameter (for example "m=SxQL3iGyoDo"), a full tour URL, or pasted embed code.

**Where the button appears.** The button appears beside **Show all photos** on desktop and beside the **Show all** pill on mobile. Listings where the field is empty show no button.

Still stuck? [Contact the HomeRunner team](https://homerunner.io/contact/) with your site address and what you tried, and we take it from there.