Seekmodo developer docs

Category merchandising

Category landing pages (e.g. /c/outerwear, /category/keys) usually want a different ranking story from free-text search. Shoppers landing on a category have already filtered themselves; you want the visual top of the grid to look intentional. The Category Merchandising surface at admin.seekmodo.com → Merchandising → Categories gives you that control without touching code.

Picking a category

The category index lists every category in your indexed catalog with the count of products in each. Click into one to land on the editor — the URL ends in the category id, so you can deep-link your merchandiser to /merchandising/category/<id>.

Sort modes

Each category picks one of four sort modes, switchable from the dropdown at the top of the editor:

• Manual. The order you drag-and-drop is the order shoppers see. Falls back to ranker order for any product you don't manually rank.
• Ranker order. The self-tuning ranker decides. Drag-and-drop is disabled; you can still apply per-product pins (see below).
• In-stock first, then ranker. Available SKUs float to the top in ranker order; out-of-stock SKUs follow in ranker order. The default for most commerce tenants.
• Blended. A weighted mix — 60% ranker, 30% margin, 10% newness by default. The weight sliders are visible to operator-scope members and saved per category.

Drag-and-drop

In Manual mode, drag any row to a new position. The editor:

• Renders the product thumbnail, title, SKU, price, and stock status so you can make a sensible call without context-switching.
• Highlights products with low recent CTR (red) and high recent CTR (green) so you can spot duds-near-the-top and stars-near-the-bottom.
• Persists each drop optimistically. A small toast in the corner says Saving… → Saved within a second. If the save fails (rare; usually a transient gateway hiccup), the row snaps back and the toast shows a retry button.

For categories with hundreds of products, use the search box at the top of the editor to filter — drag-and-drop still applies to the filtered subset and saves correctly.

Per-product pins inside a category

Independent of the category-level sort mode, you can pin individual products to specific slots inside that category. Right-click a row → Pin to position…. Pinned slots are marked with a 📌 icon and ignore the sort mode entirely. Useful for “the seasonal hero always lives in slot 1” without committing the whole category to Manual mode.

Per-region overrides

Multi-region storefronts can save a different order per region. The region picker sits at the top of the editor; an edit applies to the currently-selected region. To inherit a common base order with regional tweaks:

1. Save the base order in your default region.
2. Switch to the regional override (e.g. ca). The editor pre-fills with the default order shaded grey.
3. Drag the products that differ. Only the products you actually move are written as overrides; everything else inherits the default.

See Regions for how the region is resolved per request.

Undo & history

Every save snapshots the previous order. The history drawer (bottom-right of the editor) lets you:

• See the last 50 changes with operator + timestamp.
• Restore any prior order with one click. Restoring writes a new history row (so you can re-restore the post-revert order if needed).

History is per-region; restoring the ca override doesn't touch the default region.

Cache & rollout

Category merchandising lives on the same 5-minute connector cache as the rest of merchandising — saved changes appear on your storefront on the next refresh. The CLI flush commands shown in the merchandising runbook also flush the category cache.

Tips

• Don't pin everything. Manual mode works fine for a top-of-page hero zone; below the fold, ranker order usually beats human curation because click telemetry is honest.
• Review monthly. A pinned product can drift from being a good fit (out of stock, seasonal mismatch, price changed). The dashboard's stale pins filter surfaces rows where the pinned product is now out of stock or hasn't been clicked in 30 days.
• Use A/B for big reorders. Anything that flips more than ~20% of the slots in a category is worth shipping as an A/B experiment first.