Target Placement Guide
Dashboard Target Placement Guide
This page shows the exact position where each admin extension target renders in the merchant dashboard. Use this to choose the right target for your extension.
Order Detail Page
┌─────────────────────────────────────────────────────────┐
│ SIDEBAR │ Order #12345 │
│ │ ┌────────────────────────────────────────┐ │
│ Home │ │ Status: Confirmed [Change Status ▾] │ │
│ Orders ← │ │ Customer: John Doe │ │
│ Products │ │ Total: ৳2,500 │ │
│ ... │ │ │ │
│ │ │ ┌──────────────────────────────────┐ │ │
│ │ │ │ ORDER ITEMS TABLE │ │ │
│ │ │ │ Product A ×2 ৳1,000 │ │ │
│ │ │ │ Product B ×1 ৳1,500 │ │ │
│ │ │ └──────────────────────────────────┘ │ │
│ │ │ │ │
│ │ │ ┌──────────────────────────────────┐ │ │
│ │ │ │ ★ order.detail.block ★ │ │ │
│ │ │ │ Your extension renders here │ │ │
│ │ │ │ (below order items) │ │ │
│ │ │ └──────────────────────────────────┘ │ │
│ │ │ │ │
│ │ │ ★ order.detail.action ★ │ │
│ │ │ [Your Action Button] │ │
│ │ │ │ │
│ │ │ ★ order.detail.print-action ★ │ │
│ │ │ [Your Print Button] │ │
│ │ └────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
Context: order_id, order_status, grand_total, customer_id, store_id
Orders List Page
┌─────────────────────────────────────────────────────────┐
│ SIDEBAR │ Orders ★ order.list.action ★ │
│ │ [Your Action Button] │
│ │ ┌────────────────────────────────────────┐ │
│ │ │ ☐ │ #123 │ John │ ৳2,500 │ Confirmed │ │
│ │ │ ☑ │ #124 │ Jane │ ৳1,200 │ Pending │ │
│ │ │ ☑ │ #125 │ Ali │ ৳800 │ Shipped │ │
│ │ └────────────────────────────────────────┘ │
│ │ │
│ │ When orders are selected (☑): │
│ │ ★ order.list.selection-action ★ │
│ │ [Bulk Action Button] (e.g., "Export", "Tag")│
└─────────────────────────────────────────────────────────┘
Product Detail Page
┌─────────────────────────────────────────────────────────┐
│ SIDEBAR │ Edit Product: T-Shirt │
│ │ │
│ │ ┌──────────┐ Name: [T-Shirt ] │
│ │ │ IMAGE │ Price: [৳999 ] │
│ │ └──────────┘ Category: [Clothing ▾] │
│ │ │
│ │ Description: [........................] │
│ │ │
│ │ Variants: │
│ │ ┌────────────────────────────────────────┐ │
│ │ │ S / Red ৳999 Stock: 25 │ │
│ │ │ M / Blue ৳999 Stock: 18 │ │
│ │ └────────────────────────────────────────┘ │
│ │ │
│ │ ┌────────────────────────────────────────┐ │
│ │ │ ★ product.detail.block ★ │ │
│ │ │ Your extension renders here │ │
│ │ └────────────────────────────────────────┘ │
│ │ │
│ │ ★ product.detail.action ★ [Your Button] │
│ │ ★ product.detail.print-action ★ [Print] │
└─────────────────────────────────────────────────────────┘
Dashboard (Home) Page
┌─────────────────────────────────────────────────────────┐
│ SIDEBAR │ Dashboard │
│ │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ Home ← │ │ Orders │ │ Revenue │ │ Visits │ │
│ Orders │ │ 142 │ │ ৳45.2K │ │ 1.2K │ │
│ Products │ └─────────┘ └─────────┘ └─────────┘ │
│ ... │ │
│ │ ┌────────────────────────────────────────┐ │
│ ───── │ │ ★ dashboard.widget ★ │ │
│ Apps │ │ Your widget card renders here │ │
│ ★Flow★ ← │ │ (alongside native dashboard widgets) │ │
│ │ └────────────────────────────────────────┘ │
│ │ │
│ │ ┌────────────────────────────────────────┐ │
│ │ │ ★ dashboard.block ★ │ │
│ │ │ Full-width content block │ │
│ │ └────────────────────────────────────────┘ │
│ │ │
│ │ ┌────────────────────────────────────────┐ │
│ │ │ Recent Orders table │ │
│ │ └────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
Sidebar Navigation
┌────────────────────┐
│ SeloraX Admin │
│ │
│ 📊 Dashboard │
│ 📦 Orders │
│ 🛍️ Products │
│ 👥 Customers │
│ 📈 Analytics │
│ ⚙️ Settings │
│ │
│ ─── Apps ─── │
│ ★ navigation.link │ ← Your app's sidebar link
│ ⚡ Flow │ (e.g., "Flow", "Reviews",
│ 📦 ShipTracker │ "Inventory Manager")
│ │
└────────────────────┘
When clicked: navigates to /{store}/settings/apps/e/{your-app-slug} (embedded app page).
Global Action
★ global.action ★ renders on EVERY dashboard page, above the main content area.
Best for: notification bars, alerts, status indicators that should appear everywhere.
Target Selection Guide (Dashboard)
| I want to build... | Use target | Why |
|---|---|---|
| Shipment tracking info on orders | order.detail.block | Shows tracking data alongside order details |
| Bulk export orders to CSV | order.list.selection-action | Appears when orders are selected |
| Print shipping label | order.detail.print-action | Alongside native print actions |
| SEO score for products | product.detail.block | Shows SEO analysis on product edit page |
| Bulk tag products | product.list.selection-action | Appears when products are selected |
| Customer loyalty points | customer.detail.block | Shows points alongside customer info |
| Analytics widget on home | dashboard.widget | Card-sized widget on the dashboard |
| Full analytics section | dashboard.block | Full-width content block |
| App sidebar link | navigation.link | Adds entry to sidebar under "Apps" |
| Full settings page | settings.page | Full page in settings area |
| POS quick action | pos.action | Button on POS screen |
| Global alert bar | global.action | Shows on every dashboard page |