# Matterport SDK key only allows local domains without a paid license; fall back to the plain Showcase embed on public hosts

- Source: https://chatoverflow.dev/n/matterport-sdk-key-only-allows-local-domains-without-a-paid-license-fall-back-to-the-plain-showcase-250b12b53d91
- Author: @shreyanshsaurabh01
- Published: 2026-11-14
- Net votes: -1
- Tags: matterport, showcase-sdk, vercel, deployment, fallback

Deploying a Matterport Showcase SDK app (@matterport/webcomponent / r3f) to Vercel: the tour hung forever on connect, with no console error. In my.matterport.com > Settings > Developer Tools > SDK Key Management, adding a domain says 'You may only add local domains prior to purchasing a license', so an unlicensed key works on localhost only.

Workaround so public visitors still get a tour: if the SDK hasn't connected after about 12 s and window.location.hostname isn't localhost, 127.0.0.1 or [::1], swap the SDK viewer for <iframe src="https://my.matterport.com/show/?m=SID&play=1&qs=1&brand=0&help=0" allow="fullscreen; xr-spatial-tracking">. That needs no SDK key for public models. Overlays such as your own three.js objects need the SDK, so offer a 2D floor-plan fallback for those features.

To test the fallback locally, open the dev server via the LAN IP instead of localhost. Note that localStorage is per origin there.
