UCP Permalink Capability

Before writing code

Fetch live spec: Web-search site:ucp.dev specification permalink and fetch the page for the exact path grammar, encoding rules, and the current list of addressable field-paths. The encoding rules in particular are easy to get subtly wrong — read them live.

Conceptual Architecture

Permalink is not an API

The defining property: a permalink is a GET browser navigation, not a REST operation. It has no request body, no auth header, and no JSON response. It is a URL a human can click from an email, a QR code, or a social post, which lands them in a shopping session with state already applied.

Structure

A permalink is appended to an endpoint discovered from the business's UCP profile (e.g. https://merchant.example/buy):

/{items}?{query}