routing

Links, the router, page params and the merchant's site pages.

import { … } from '@poltura/theme-sdk/routing';

Hooks

Name	What it is
`useRouter`	The router, for moving the visitor from code.
`usePathname`	The path of the current page.
`useSearchParams`	The query string of the current page.
`usePageParams`	The params the current theme page's route captured.
`useSitePage`	The merchant's site page the current page renders.
`useNotFoundPage`	The not-found page the visitor is on, for the section that draws it.

Name	What it is
`Link`	A link inside or out of the store that navigates without a full page load where it can.

Name	What it is
`redirect`	Stops rendering the page and sends the visitor to another one.
`notFound`	Stops rendering the page and shows the store's not-found page.
`pageHref`	The URL of a site page.

Name	What it is
`LinkProps`	Props of `Link`.
`Router`	Navigation actions for code that moves the visitor without a link.
`PageParams`	The params a theme page's route captured, such as `slug`; a catch-all's rest is under `$`.
`SitePageRef`	A link to one of the merchant's site pages.
`SitePage`	One of the merchant's site pages, with its place among the others.
`NotFoundPageTexts`	The store's wording on its not-found page, in the page language.
`NotFoundPage`	What the store's not-found page shows: its wording and the categories it suggests instead.

Last updated Oct 29, 2026