# Navigation Customization in Store OS

## Overview

Navigation Customization in **Store OS** allows merchants to control and personalize the side menu of their Store OS panel. You can decide which items appear, change their order, and add helpful custom links (such as internal tools) to match your daily workflows.
This configuration is done at the store level and applies to the selected sales channel. Only users with **Admin access** can modify navigation settings.

How to Access Navigation Settings 
Store OS > Configuration > Navigation

### **Navigation Layouts**

Navigation can be configured separately for different device layouts:

#### **Landscape (Desktop & Tablets)**

* Side menu is **scrollable**
* No restriction on the number of active items


#### **Portrait (Mobile)**

* Maximum **5 active menu items** allowed
* Extra items must be moved under **More**


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/1.jpg)

center
em
Figure 1: Navigation Layouts
br
## **Navigation Setup**

Store OS uses a **two-level menu system**:

* **Level 1 (Primary Menu):** Main items visible in the sidebar
* **Level 2 (More Menu):** Sub-items grouped under the **More** option


All new stores come with a default navigation structure to help you get started quickly. These are built-in Store OS pages:

* Cart
* Products
* Customers
* Orders
* Collections
* Extensions
* Analytics
* Inventory
* Cash Management
* Support


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/2.jpg)

center
em
Figure 2: Primary Menu & More Menu
br
## Features

Navigation customization helps you to:

* **Reorder Menu Items**
  * Drag and drop menu items using the drag handle
  * Reordering works for both primary and sub-menu items


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/3.jpg)

center
em
Figure 3: Reorder Menu Items 
br
* **Show or Hide Menu Items**
  * Use the checkbox next to a menu item to activate or deactivate it
  * Deactivated items will not appear in the sidebar


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/4.jpg)

center
em
Figure 4: Show or Hide Menu Items 
br
* **Rename Menu Items**
  * **System pages:** Can be renamed, but their icons cannot be changed
  * **Custom links:** They can be renamed, and their icons can be updated
  * **Connected Apps:** They can be renamed, and their icons can be updated
![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/5.jpg)


center
em
Figure 5: Rename Menu Items 
br
## **Adding a New Menu Item**

1. Click **Add New Menu Item** at the bottom of the list


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/6.jpg)

center
em
Figure 6: Add New Menu Item 
br
1. A new menu item will be added


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/7.jpg)

center
em
Figure 7: New Menu Item Created 
br
1. Click the **link icon** to configure where it should redirect


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/8.jpg)

center
em
Figure 8: Add Link to Menu Item 
br
1. There are three types of menu items
  1. **System Pages**: These are built-in Store OS pages like:
    1. Products
    2. Orders
    3. Customers
    4. Analytics
    5. Collections
  2. **Custom Links (URLs):** Custom links let you add external or internal URLs to the navigation, such as training resources or internal dashboards.
  3. **Connected Apps:** Connected Apps are extensions integrated with Store OS that provide additional functionality. Once enabled from **Configuration** > **Extension** > **Connected Apps**, they can be added to the navigation menu.


System pages cannot be duplicated at the same level. Icons for system pages cannot be changed.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/9.jpg)

center
em
Figure 9: Select Link Type 
br
1. For custom URLs, select **Link Type** as **Custom URL** and enter a valid **https URL**
2. Add an optional description (up to 50 characters)
3. You can control how the link opens:
  * **Open inside Store OS**: The link opens within the Store OS interface.
  * **Open in browser (New Tab)**: The link opens in a separate browser tab.
Select the option based on your business requirement.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/10.jpg)

center
em
Figure 10: Add URL & Description 
br
1. Rename the newly added menu item


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/11.jpg)

center
em
Figure 11: Rename Menu Item 
br
1. Click **Save** at the top-right of the page


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/12.jpg)

center
em
Figure 12: Save Configuration
br
1. Changes are applied instantly to your store navigation


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/13.jpg)

center
em
Figure 13: Updated Navigation
br
1. In addition to system pages and custom URLs, you can also add **Connected Apps** directly to your navigation menu.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/14.jpg)

center
em
Figure 14: Connected Apps in Navigation
br
1. Ensure the checkbox next to the item is enabled. You can also rename the app if required.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/15.jpg)

center
em
Figure 15: Rename App
br
1. Click **Save**. The connected app is now linked to the menu item.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/16.jpg)

center
em
Figure 16: Click Save
br
1. Custom icons can only be updated for:
  * Custom links
  * Connected Apps added to navigation


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/custom-navigation/custom-navi-rework/17.jpg)

center
em
Figure 17: Change Icon/em>
br
For system pages, only the name can be changed. The icon cannot be modified.

## Extension Binding in Store OS

**Extension Binding** lets company admin or store manager decide **if an extension should appears inside Store OS**. There are two types of extensions based on where they are available in the system.

1. **Page-specific extensions**: They are available only on specific pages or sections in Store OS. These extensions enhance a specific workflow. For examples, Customise Product appears on the Product Details page.
2. **Connected Apps**: They are available across Store OS and are not tied to a specific page. They provide standalone functionality and appear under the Extensions section.


Extension binding controls **where an extension appears**, not whether it is installed.

### Steps to Configure Extension Binding

How to Access Navigation Settings 
Store OS > Configuration > Extensions

1. The Extension settings have two tabs: **Pages** and **Connected Apps**.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/extension-binding/1.jpg)

center
em
Figure 14: Extension Configurations  
br
1. In the **Pages** tab, extensions are grouped by specific pages such as **Shipment Details** and **Product Details**. Each page lists the apps that can be used in that context.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/extension-binding/2.jpg)

center
em
Figure 15: Pages for Binding Extensions 
br
1. You can enable or disable an app using the toggle to make it available on that specific page. For example, we enable **View Customisations** extension.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/extension-binding/3.jpg)

center
em
Figure 16: Enable Extensions on Pages 
br
1. Click **Save** to apply the changes. The enabled extension will then appear on the corresponding page .i.e. shipment details page in Store OS.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/extension-binding/4.png)

center
em
Figure 17: Extensions on Pages 
br
The same extension can be enabled in one page and disabled in another.

1. Similarly, in the **Connected Apps** tab, you can enable or disable extensions based on your business requirements. For example, we enable **Order Validation STOS** extension.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/extension-binding/5.jpg)

center
em
Figure 18: Connected Apps 
br
1. Click **Save** to apply the changes. The enabled extension will then appear in the **Extensions** menu.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/extension-binding/6.jpg)

center
em
Figure 19: Available Extensions 
br