Skip to main content

​
What Is This?

By default, your Planpoint embed opens at the top-level view when a visitor lands on your page. Deep-linking lets you share a URL that skips straight to a specific unit — or to a whole collection (a curated group of units, such as “The City Studios”). It’s useful for email campaigns, ads, or any page where you want to highlight a particular listing or collection.

​
Before You Start

This guide assumes you already have a Planpoint embed on your website. If you haven’t set that up yet, follow the How to Embed Planpoint on your website guide first, then come back here.
Looking for Enterprise map parameters like project=, pois=true, or grid=false instead? See Enterprise Map & Points of Interest.

​
Step-by-Step

​
Step 1 — Find your unit’s details

In your Planpoint dashboard, open the project that contains the unit you want to link to and note down:
  • The unit name — the number or label shown on the unit card (e.g. 202, Unit A)
  • The collection name (optional) — the collection you want to open (e.g. The City Studios), exactly as named in your dashboard. Use this to land on a whole collection instead of a single unit
  • The collection link slug (optional) — only needed for pretty-path links. Set it on the collection’s Edit screen (e.g. city-studios)
  • The floor name (optional) — the floor that unit is on (e.g. Floor 2). Only needed if the same unit name appears on more than one floor
  • The project name (group and enterprise embeds only) — the full project name as entered in your dashboard (e.g. Riverside Tower). Only needed if multiple projects in your group or enterprise share unit names

​
Step 2 — Go to the page where your embed lives

Open the page on your website that contains the Planpoint embed. Copy its full URL from the browser address bar. Example:

​
Step 3 — Add the parameters

Append ?u= followed by the unit name to the end of your URL:
If you also want to specify the floor:
If you have a group or enterprise embed and want to pin to a specific project:
To open a whole collection instead of a single unit, use ?c= followed by the collection name:
Shortcut: In your dashboard, open the project’s Collections tab and click Copy link next to any collection. This copies a ready-made deep-link for that collection — no need to build the URL by hand.
Paste the URL into a new browser tab. The embed should open directly on the unit you specified. If it opens on the main view instead, double-check that the unit name, floor name, and project name match exactly what is in your dashboard. You can now use this URL anywhere — in an email, an ad, a button on another page, or a QR code.

​
Parameter Reference

​
Usage by Embed Type

​
Project Embed

f and p are both optional. ?u=202 alone is enough:
If the same unit number exists on multiple floors, add f to be precise:

​
Group Embed

Works the same way. Add p only if multiple projects share the same unit names:
If the project has the Skip Floor Step setting enabled (used for commercial spaces with no floors), use u alone — there is no floor to specify:

​
Enterprise Embed

Same as group, but searches across all projects and groups within the enterprise:

​
Linking to a Collection

Collections work with project, group, and enterprise embeds. Use c on its own to open straight on a collection:
In a group or enterprise embed, Planpoint automatically opens the project that owns the collection — you don’t need to add p.

​
Pretty-Path Links (using your page URL)

If your collections live behind tidy URLs like:
Planpoint can open the matching collection automatically — no ?c= needed. It reads the last segment of the page path (city-studios above) and opens the collection whose link slug matches it. Set the slug in your dashboard: open the project’s Collections tab, click Edit on a collection, and set the Link slug field (e.g. city-studios). It defaults to a slug based on the collection name, so most collections work out of the box — only change it if you want it to match a specific path on your site. This works on any platform (Webflow, WordPress, Squarespace, etc.) with no extra setup — just add the embed to the page. If a path segment doesn’t match any collection, nothing changes and the embed opens normally. A ?c= in the URL always takes priority over the path.

​
Matching Rules

  • Unit name (u) — must match exactly, including capitalisation (e.g. 202, Unit A)
  • Floor name (f) — must match exactly, including capitalisation (e.g. Floor 2, Level 3)
  • Project name (p) — case-insensitive exact match (p=riverside tower matches “Riverside Tower”)
  • Collection name (c) — case-insensitive exact match (c=the city studios matches “The City Studios”)
  • When p is omitted in a group or enterprise embed, the first unit with a matching name is opened

​
URL Encoding

Spaces and special characters must be percent-encoded in URLs: So “Floor 2” becomes Floor%202 and “Riverside Tower” becomes Riverside%20Tower. Most website builders (Webflow, WordPress, Squarespace) handle this automatically when you paste a URL into a link field.

​
Quick Examples

​
Locked or Portal-Protected Viewers

If your viewer uses a Lock Screen or portal login, deep-links still work. The visitor is asked to log in or register first, and is then taken straight to the linked unit or collection — the link is never skipped, so your lead capture stays intact.