# 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)

Figure 1: Navigation Layouts
## **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)

Figure 2: Primary Menu & More Menu
## 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)

Figure 3: Reorder Menu Items 
* **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)

Figure 4: Show or Hide Menu Items 
* **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)


Figure 5: Rename Menu Items 
## **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)

Figure 6: Add New Menu Item 
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)

Figure 7: New Menu Item Created 
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)

Figure 8: Add Link to Menu Item 
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)

Figure 9: Select Link Type 
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)

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


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

Figure 11: Rename Menu Item 
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)

Figure 12: Save Configuration
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)

Figure 13: Updated Navigation
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)

Figure 14: Connected Apps in Navigation
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)

Figure 15: Rename App
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)

Figure 16: Click Save
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)

Figure 17: Change Icon/em>
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)

Figure 14: Extension Configurations  
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)

Figure 15: Pages for Binding Extensions 
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)

Figure 16: Enable Extensions on Pages 
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)

Figure 17: Extensions on Pages 
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)

Figure 18: Connected Apps 
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)

Figure 19: Available Extensions