# Map links and saved views

The URL format that opens a specific LookAlike map view, and how saved views record the data release and store points.

A map link encodes the complete map state in the URL fragment. The fragment is the part after `#`. Agents can build links with the `make_map_link` tool or by hand.

## Parameters

Parameter

Meaning

Example

`brand`

Curated brand id, or `dataset:<id>` for a client dataset

`brand=trader_joes`

`mode`

`markets` or `compare`. Explore is the default.

`mode=markets`

`cmp`

Second brand in compare mode

`cmp=whole_foods`

`metro`

Metro CBSA code

`metro=19740`

`state`

Two-digit state FIPS code

`state=08`

`sel`

Selected 11-digit tract GEOID

`sel=08031001705`

`ll`

Site pin as latitude and longitude

`ll=39.75302,-105.00012`

`open`

`1` hides tracts that hold a store. `0` shows them.

`open=0`

`min`

Minimum similarity percentile

`min=90`

`km`

Minimum distance from the brand’s nearest store, in km

`km=5`

`nc`

`1` hides tracts within 6 km of a competitor’s store

`nc=1`

`cs`

Chosen competitor brands. Omit it for the brand’s own category. `-` means none.

`cs=whole_foods,sprouts`

`su`

`1` includes special-use tracts in rankings

`su=1`

`w`

Theme weights, in theme order

`w=1,2,1,1,0`

`fw`

Feature weights as `key:value` pairs

`fw=median_age:0`

`mm`

Markets metric: `fit` or `headroom`

`mm=headroom`

`pin`

Tracts to add to the shortlist

`pin=08031001705,08005005551`

`release`

National data release to load

`release=2026-10-05-01`

`view`

Saved view id

`view=0123456789abcdef0123456789abcdef`

`t`

Title shown on the sign-in page, up to 120 characters

`t=Trader%20Joe%27s%20%C2%B7%20Denver`

Example:

```
https://app.lookalikeiq.com/#brand=trader_joes&metro=19740&min=90&sel=08031001705&release=2026-10-05-02&t=Trader%20Joe%27s%20%C2%B7%20Denver
```

## Saved views

A saved view stores the map state on the server. It also stores the data release, the model version, and optional store points. The link is short: `https://app.lookalikeiq.com/#view=<id>`.

Parameters after the `view` parameter override the saved state. For example, `#view=<id>&sel=08031001705` opens the saved view with that tract selected.

The **Copy link** button in the map saves a view when you are signed in. Agents save views with `save_view`, with `shortlist_top` in `find_candidates`, or automatically when an analysis uses a `stores` list. Saving the same view again returns the same link.

The creator can open a saved view. Members of the creator’s organizations can also open it. Agents list saved views with `list_views`. The creator can rename or delete a view with `rename_view` or `delete_view`.

## Data releases

A link with `release` loads that national data release. Scores in the link therefore stay the same after a new release. When a newer release exists, the map shows a notice. **Use current data** reloads the view on the current release.

Canonical URL: https://docs.lookalikeiq.com/agents/map-links/
