> 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: wix-router



## Article: Introduction

## Article Link: https://dev.wix.com/docs/velo/events-service-plugins/routers/service-plugins/wix-router/introduction.md

## Article Content:

# Introduction
> **Note:** This feature is not yet supported in
[Wix Blocks](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/wix-blocks/about-wix-blocks.md).

The Wix Router API allows you to handle certain incoming requests to your site's pages and sitemap and customize the responses.

Some things you might do with the Router API are:
 * Control the URL structure of your site.
 * Customize your site's sitemap.
 * Extend [dynamic pages](https://support.wix.com/en/article/content-manager-about-dynamic-pages) to include subpages that use different data.
 * Cache router response data used to display pages.

The API gives you access to the following:
 * Requests to certain pages on your site and routing responses for those pages.
 * Sitemap requests and responses.
 * Hooks to control the flow of the data used to display pages returned by the router or sitemap. Hooks are often used when working with the code for [dynamic pages](https://support.wix.com/en/article/velo-about-data-hooks-for-dynamic-pages).


## Router caching
To enhance performance, you can implement caching for your router responses using the [`ok()` function](wix-router/ok). Router caching allows you to temporarily store the function's return value, reducing response times and the need to repeatedly fetch data every time a visitor makes a request on your site. Learn more about [router caching](https://dev.wix.com/docs/develop-websites/articles/best-practices/caching/about-router-caching.md).


## Before you begin

It's important to note the following points before starting to code:
- Code using the Routers API is stored in the **routers.js** file in the backend code section the Code sidebar. You shouldn't create this file manually.
- The file is created automatically when you [add a router](https://support.wix.com/en/article/velo-creating-a-router#add-a-router) to your site.

To use the [`router()`](wix-router/router) and [`sitemap()`](wix-router/sitemap) functions in the **routers.js** file, use the following convention:

```js
export function <router prefix>_<function name>()
```

To import the other API functions into the **routers.js** file, use the following syntax:

```js
import { <function-name> } from 'wix-router';
```

 Get hands-on experience with the Routers API on our [Hello Routers](https://www.wix.com/velo/example/hello-routers) example page.

## Terminology

 * **Router**: Part of the code on your site that receives requests for specific URLs and handles which page is 
   served and what data is included in that page.
 * **Sitemap**: A model of a site's content structure, designed to help both users and search engines navigate the site.
 * **Data binding router hooks**: Functions that run before, during, and after data is included in 
   the pages that the router and sitemap functions return. Router hooks are often used when working with [dynamic pages](https://support.wix.com/en/article/velo-about-data-hooks-for-dynamic-pages). The API includes 4 hooks:
     * [`beforeRouter`](wix-router/beforeRouter)
     * [`customizeQuery`](wix-router/customizeQuery)
     * [`afterRouter`](wix-router/afterRouter)
 * **Caching**: The process of storing frequently accessed data in a temporary storage location so that it can be retrieved more quickly, improving the performance and speed of your site.