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

# Customize the core rail: pin and reorder modules

> Pin your most-used cores to the top of the sidebar rail and drag-to-reorder them. Per-user preferences sync across browsers and sessions.

The **core rail** is the 56px icon column on the left edge of Encore OS. It lists every core you have access to plus Dashboard, Inbox, and Settings. You can personalize the rail by pinning the cores you use most to the top and dragging the rest into the order you prefer.

## Overview

Pinning and reordering are per-user preferences stored on your profile, so the rail looks the same on every browser and device where you sign in. Two sections sit between Inbox and the bottom toolbar:

* **Pinned cores** — appear directly under the Dashboard/Inbox group, in the order you set.
* **Other cores** — every other core you have access to, in the order you set.

A thin separator divides the two sections once you have at least one pinned core. Cores you lose access to are dropped silently the next time the rail loads; cores you gain access to appear at the end of the **Other cores** section.

## Who it's for

Anyone who uses Encore OS. There are no permissions required — you customize your own rail. Admins can't pre-pin or pre-order the rail for other users; the seed order matches the order the cores were granted to you.

## Before you start

* Sign in to Encore OS on desktop. Pin and reorder controls are desktop-only because the mobile nav uses a different layout.
* Make sure you have access to at least two cores so there's something to pin or reorder.

## Pin a core to the top

<Steps>
  <Step title="Right-click a core icon">
    Right-click (or two-finger click on macOS) the icon for the core you want to pin. A context menu appears.
  </Step>

  <Step title="Select Pin to top">
    Select **Pin to top**. The icon moves into the pinned section directly under Inbox.
  </Step>

  <Step title="Repeat for additional cores">
    Pin as many cores as you like. New pins are appended to the bottom of the pinned section — drag to reorder once they're in place.
  </Step>
</Steps>

To unpin, right-click the pinned icon and select **Unpin from top**. The core moves back into the **Other cores** section in its previous position.

## Reorder cores by dragging

<Steps>
  <Step title="Press and hold a core icon">
    Click and hold a core icon, then move the pointer at least 8 pixels. The icon lifts into a drag state and the rest of the section makes room.
  </Step>

  <Step title="Drop into the new position">
    Drag up or down within the same section and release. Pinned cores reorder inside the pinned section, and other cores reorder inside the **Other cores** section. You can't drag across the separator. To move a core between sections, pin or unpin it first.
  </Step>
</Steps>

A short click that doesn't travel 8 pixels still navigates to the core, so reordering never blocks normal selection.

## Keyboard reordering

The rail supports keyboard drag-and-drop for accessibility:

1. **Tab** to the core icon you want to move.
2. Press **Space** to pick it up.
3. Use **Arrow Up / Arrow Down** to move it within its section.
4. Press **Space** again to drop, or **Escape** to cancel.

Pinning is also keyboard-accessible: focus the icon, press the **Menu** key (or Shift+F10) to open the context menu, then select **Pin to top** or **Unpin from top**.

## Key concepts

* **Pinned section** — cores you've explicitly pinned, kept above the separator. Order is preserved exactly as you set it.
* **Other cores section** — everything else you can access, in the order you set (or the default order if you haven't reordered).
* **Per-user preference** — pin state and order live on your profile, not your organization. Two users in the same org will see different rails.
* **Stale entries dropped** — if you lose access to a core, it disappears from your rail and your saved order the next time the rail loads. You don't have to clean up manually.

## Related

<Columns cols={2}>
  <Card title="Workspaces" icon="grid-2" href="/pf/workspaces">
    Compose cross-core nav lenses for a role-focused sidebar.
  </Card>

  <Card title="Modules" icon="layer-group" href="/pf/modules">
    Enable or disable the cores that appear on the rail.
  </Card>
</Columns>
