> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Url Mapping V1

# Type: Url Mapping Object

# Link: https://dev.wix.com/docs/api-reference/business-management/seo/url-mapping-v1/url-mapping-object.md

## Description: A custom URL pattern for one type of item page on a site, such as all Stores product pages.

A site has at most one URL mapping per `key`. When a site has no URL mapping for a key, the
item pages use the key's default URL, which depends on the key. For example, Stores product
pages default to `<prefix>/{{slug}}` and Blog category pages to `<prefix>/categories/{{slug}}`.

## Schema:

```json
 Type: Url Mapping Object | type: UrlMapping
 Description: A custom URL pattern for one type of item page on a site, such as all Stores product pages.

A site has at most one URL mapping per `key`. When a site has no URL mapping for a key, the
item pages use the key's default URL, which depends on the key. For example, Stores product
pages default to `<prefix>/{{slug}}` and Blog category pages to `<prefix>/categories/{{slug}}`.
       - name: key  | type: string | description: Type of item page this URL mapping applies to, and the variables its `mapping` must use: + `wix.stores.sub_pages.product`: Stores product page. Variables: `slug`. + `wix.blog.sub_pages.post`: Blog post page. Variables: `slug`. + `wix.blog.sub_pages.category`: Blog category page. Variables: `slug`. + `wix.bookings.sub_pages.service_page`: Bookings service page. Variables: `slug`. + `wix.online_programs.sub_pages.online_program`: Online Programs program page. Variables: `slug`. + `wix.forum.sub_pages.category`: Forum category page. Variables: `slug`. + `wix.forum.sub_pages.post`: Forum post page. Variables: `categorySlug`, `postSlug`. + `wix.groups.sub_pages.group`: Groups group page. Variables: `groupId`, `tabName`.  Other values aren't supported.
       - name: mapping  | type: string | description: URL pattern for the item pages, relative to the site's base URL. Wrap variables in double curly braces, for example `shoes/{{slug}}`. The pattern must use every variable listed for its `key`, and no others. The pattern is saved in lowercase.  Rules: up to 1,000 characters; no spaces, emoji, or URL-reserved characters; no leading or trailing slash; no empty segments; at most one variable per segment. The resulting URLs can't collide with another page on the site or with another URL mapping.

```