Skip to main content
Subnav links allow you to embed external pages or applications directly into the Kibo Admin UI navigation. They are registered as entities in the subnavlinks@mozu entity list. Make a POST request to the entity list endpoint:

Request Payload

Field Descriptions

Available location Values

These control where in the Admin UI the subnav link will appear: Note: Additions to productsmenu require a hard refresh to display. Other locations such as categoriesedit or productsedit appear after a single refresh.

How Requests Are Delivered to Your Application

When a user clicks a subnav link in Admin, Kibo makes a POST request to your configured href URL. The request includes:

Query Parameters

POST Body (form-encoded)

Verifying Request Authenticity

Use the dt and messageHash query parameters to confirm the request genuinely came from Kibo Admin. The following Node.js example shows the verification algorithm:
Your appSecret comes from the application registered in Kibo. The appId in the subnav link payload must match that same application. Via API:
Via Admin UI:
  1. Go to System > Schema > Custom Schema.
  2. Open Dev Tools and run: Ext.util.Cookies.set('debugext', true)
  3. Press Enter and refresh the page.
  4. Under Entity Lists, find subnavlinks to view or delete entries.

Example Demos

A reference implementation (Express server + Next.js) is available at github.com/KiboPartners/subnavlink-demos.