> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tetherdata.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Navigation & interface

> Learn how to navigate the Tether interface effectively

# Navigation & interface

Tether's interface is designed for efficiency, with intuitive navigation and powerful data management capabilities. This guide helps you understand the layout and key interface patterns.

## Main layout

The Tether interface consists of these primary areas:

* **Top navigation bar** - Logo, search, and user menu
* **Sidebar navigation** - Main feature navigation (collapsible)
* **Main content area** - Where you'll do most of your work

## Sidebar navigation

The sidebar is your primary navigation tool. It can be expanded or collapsed to maximize screen space.

The sidebar is organized into groups. Which groups you see depends on your role, your permissions, and which features are enabled for your organization — so your sidebar may show a subset of the groups below.

| Group                      | Pages                                                                                                     |
| -------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Command Center**         | A configurable landing dashboard (shown only for organizations with a Command Center preset)              |
| **Agent**                  | Chat Sessions, Memory                                                                                     |
| **Demand**                 | Dashboard, Comparison, Edit Log, Admin                                                                    |
| **Marketing & Promotions** | Drivers, Promotions                                                                                       |
| **Inventory**              | Dashboard, Warehouses, Suppliers, Lots                                                                    |
| **Transactions**           | Transactions                                                                                              |
| **Supply Chain**           | Locations, Policies, Connected Planning, Transfer, Production, Purchase, MRP, Execution plan, Data issues |
| **Principal Catalog**      | Attribute, SKU, SKU Group, BOM                                                                            |
| **Catalog**                | Collections, SKUs (legacy organizations only)                                                             |
| **Sales**                  | Sales Channels, Sales History                                                                             |

<Note>
  Several sidebar labels (such as Locations, Policies, Attribute, SKU, SKU Group, and BOM) can be renamed per organization in **Settings** → **Terminology**, so your labels may differ from the defaults shown here.
</Note>

<Info>
  **Settings** is accessed from the user menu (profile avatar) in the top-right corner, not from the sidebar. Only Admins can see the Settings option.
</Info>

### Collapsing the sidebar

Click the collapse button at the bottom of the sidebar to minimize it. This gives you more screen space for data-heavy views like the SKU dashboard or forecast tables.

## Settings navigation

Settings pages open in their own layout with a dedicated sidebar, organized into these groups:

| Group              | Pages                                                                                                                   |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| **General**        | Profile, Theme, Terminology, Documents                                                                                  |
| **Catalog**        | Collection Hierarchy, SKU Group Hierarchy, Channel Hierarchy, Working-days Calendars, Lot Tracking                      |
| **Forecasting**    | Forecast Admin, Inventory & Forecast, Period Management, Forecast Edit Log, Automatic Re-planning                       |
| **Integrations**   | Data Ingestion, BigQuery, API Keys, MCP                                                                                 |
| **Agent**          | Agent Templates, Agent Files                                                                                            |
| **Access**         | Channel Access, Members                                                                                                 |
| **Administration** | Setup & Health, Principal Setup & Health, ERP SKU ID Sync, Mapper Config, Data Management, Feature Flags, Organizations |

Like the main sidebar, settings pages are gated by role and permissions — most users see only a subset of these pages.

## Top navigation bar

The top bar provides:

* **Logo/Home**: Click to return to the main dashboard
* **Search**: Quick access to the command palette (also `Cmd+K` / `Ctrl+K`)
* **User Menu**: Access settings (Admin only), view your role, and log out

## Page layouts

### Tab-based pages

Many pages use tabs to organize related content. For example, the Inventory page has:

* **Inventory** - Current stock levels across warehouses
* **History** - Inventory changes and adjustments over time
* **Approvals** - Adjustment requests awaiting review
* **My requests** - Adjustment requests you've submitted

<Tip>
  Tab selection is preserved in the URL, so you can bookmark or share links to specific tabs.
</Tip>

### Detail pages

When you click into a specific item (SKU, warehouse, transaction, etc.), you'll see a detail page with:

* **Header**: Name, status, and quick actions
* **Tabs**: Different aspects of the item
* **Content Area**: Forms, tables, or visualizations

## Data tables

Tether uses powerful data tables throughout the application. Here's how to use them effectively:

### Column features

| Feature     | How to Use                                          |
| ----------- | --------------------------------------------------- |
| **Sort**    | Click column header to sort ascending/descending    |
| **Resize**  | Drag column borders to adjust width                 |
| **Reorder** | Drag column headers to rearrange                    |
| **Pin**     | Right-click header to pin columns left or right     |
| **Hide**    | Use column visibility controls to show/hide columns |

### Inline editing

Many tables support inline editing:

1. Click on an editable cell (indicated by subtle highlighting on hover)
2. Make your changes
3. Press `Enter` to save or `Escape` to cancel
4. Changes are saved automatically

<Warning>
  Some fields may require specific formats (dates, numbers, etc.). Invalid entries will show an error.
</Warning>

### Filtering

Tables typically include a filter panel on the left side:

* **Text Search**: Type to search across visible columns
* **Multi-Select Filters**: Check/uncheck values to filter
* **Tri-State Selection**: Some filters support Include/Exclude/Indifferent states
* **Date Ranges**: Select start and end dates for time-based filtering

### Row selection

* **Single Select**: Click a row to select it
* **Multi-Select**: Hold `Cmd` (Mac) or `Ctrl` (Windows) and click multiple rows
* **Range Select**: Click first row, hold `Shift`, click last row

## Modal dialogs

Modals appear for:

* Creating new items
* Editing details
* Confirming actions
* Viewing additional information

### Modal controls

* **Close**: Click the X button or press `Escape`
* **Save**: Click the primary action button (usually blue)
* **Cancel**: Click Cancel or close the modal

<Info>
  Some modals have multiple steps. Look for "Next" and "Back" buttons to navigate.
</Info>

## Filters & saved views

### Using filters

1. Open the filter panel (usually on the left side of data tables)
2. Expand filter sections by clicking the headers
3. Select values to include or exclude
4. Results update automatically

### Tri-state filtering

Some filters support three states:

| State           | Icon | Meaning                             |
| --------------- | ---- | ----------------------------------- |
| **Include**     | ✓    | Show only items matching this value |
| **Exclude**     | ✗    | Hide items matching this value      |
| **Indifferent** | -    | Don't filter by this value          |

### Saving views

If you frequently use the same filter combination:

1. Set up your desired filters
2. Click **Save View**
3. Enter a name for the view
4. Access saved views from the dropdown

## Command palette

The command palette provides quick access to navigation and search. It lists every page you can see in the main sidebar and the settings sidebar (respecting your permissions and your organization's terminology), plus a few pages that live outside both navs, such as Location Groups and Sales Orders.

<Steps>
  <Step title="Open Command Palette">
    Press `Cmd+K` (Mac) or `Ctrl+K` (Windows)
  </Step>

  <Step title="Search">
    Type to search for:

    * Pages and navigation items
    * SKUs by name or code
    * Warehouses
    * Suppliers
    * Transactions
  </Step>

  <Step title="Navigate">
    Use arrow keys to select, `Enter` to navigate
  </Step>
</Steps>

## Responsive design

Tether works on various screen sizes:

* **Desktop**: Full sidebar and expanded data tables
* **Tablet**: Collapsible sidebar, scrollable tables
* **Mobile**: Simplified navigation, stacked layouts

<Tip>
  For the best experience with data-heavy features like forecasting, use a desktop or large tablet display.
</Tip>

## Keyboard shortcuts

| Shortcut       | Action                        |
| -------------- | ----------------------------- |
| `Cmd/Ctrl + K` | Open command palette          |
| `Escape`       | Close modal or cancel editing |
| `Enter`        | Confirm/save in forms         |
| `Tab`          | Move to next field            |
| `Shift + Tab`  | Move to previous field        |

## Next Steps

<CardGroup cols={2}>
  <Card title="User Roles" icon="users" href="/roles-permissions">
    Understand what you can access based on your role
  </Card>

  <Card title="Command Palette" icon="keyboard" href="/tips/command-palette">
    Master quick navigation with keyboard shortcuts
  </Card>

  <Card title="Supply Planning Overview" icon="clipboard-list" href="/supply-planning/overview">
    See how plans are generated and reviewed
  </Card>

  <Card title="Agent Chat" icon="message" href="/agent/chat">
    Work with Tether's AI agent from anywhere in the app
  </Card>
</CardGroup>