docs/articles/hubs/routing.md

Routing

What

Stoplight’s Hubs features an easy to use routing system to make sure your docs have identifiable and friendly URL’s. The routing system allows customization of the following objects:

• Your Hub
• Pages within a Hub (link)
• Subpages within a Hub (link)
• Headers + Footers (link)
• Links

Friendly URLs are links that are easily readable, rememberable, and relevant to the content. Take a look at the URL for this page. Instead of something like https://help.stoplight.io/docs/fnIenof/123, it is https://help.stoplight.io/docs/hosted-documentation/create-friendly-urls, which is much nicer. </>

How

Pages & Subpages

1. Select the Hub you wish to modify
2. Add a new page or subpage (link)
   1. Select a page title to auto-fill the Page Route or
   2. Input a custom page route
3. Select an existing page or subpage
4. Select the gear icon at the top of the Hub in the center of the page or subpage you wish to modify
   1. Input a new URL under Page Route

Headers & Footers

1. Select the Hub you wish to modify
2. Add a new header or footer (link) or
3. Hover over an existing header or footer and click the gear icon a. Input a Path to Page or image URL