/admin/ecommerce/products you can search and filter your products, jump directly to any product editor, and manage categories, brands, and images — all in one place. Each product edit page features a sticky anchor quick-nav bar, a TinyMCE rich-text editor, a cross-selling panel, and full control over image sets, orientations, and alt text.
Product Catalog
The main product catalog is accessible atGET /admin/ecommerce/products and displays 25 products per page. From here you can search, filter, and jump directly to any product’s edit page.
At the top of the product list, the Recently Edited Products dashboard widget shows the 5 most recently edited products, each with a thumbnail, title, price range, and last-edited timestamp. Quick Edit and View Site links are provided for each entry so you can jump directly back to work or preview the live page.
Product Edit Page
Navigate toGET /admin/ecommerce/products/{id}/edit to open the full product editor.
Anchor Quick-Nav Bar
A sticky navigation bar at the top of the edit page provides instant jump-links to each major section:Product Details
Core fields: title, descriptions, categories, brand, images
Prices & Variants
Pricing tiers, variant attributes, subscription IDs
Advanced Settings
Checkout behavior, layout, redirects, featured flag
View Product Page
Opens the live storefront page for this product
Product Descriptions
Long Description (TinyMCE Rich Text Editor)
The Long Description field uses the full TinyMCE editor with the complete toolbar:TinyMCE Toolbar Features
TinyMCE Toolbar Features
- Styles — paragraph, heading (H1–H6), and preformatted styles
- Bold / Italic / Underline / Strikethrough
- Ordered and unordered lists
- Text alignment — left, center, right, justify
- Link insertion — internal or external URLs
- Image insertion — insert images from URL or uploaded media
- Supercode — inline code block mode (see below)
- Fullscreen — distraction-free editing mode
Supercode (Ace Editor)
Clicking <> opens an inline Ace Editor overlay with:Short Code Inclusion In Product Description Fields
The Short and Long Description field supports dynamic shortcode directives — you can embed shortcodes directly in this field using the standard directive syntax. See the Shortcode Reference for the full list of available directives.Categories Management
GET /admin/ecommerce/categories
Recursive Nested Tree
Categories are displayed as a full recursive nested tree. Parent–child relationships are preserved at unlimited depth.
Drag-and-Drop Sort
Reorder categories within any level by dragging rows. Changes save automatically.
Menu Visibility Controls
Each category has a visibility toggle that controls whether it appears in storefront navigation menus.
Product Count Badge
The product count badge on each category opens a right-panel list of all products assigned to that category.
- Pagination: 25 categories per page
- Product Assignment: assign a product to one or more categories from the product edit page
Brands Management
GET /admin/ecommerce/brands
Full brand CRUD is available from the Brands admin panel. Each brand record supports:
- Pagination: 25 brands per page
Product Image Management
Image URL Resolution
Every product image path is resolved using the following priority chain:1
Direct URL Source Flag
If
image_url_source = 1 on the image set → the stored path is returned immediately as a direct external URL with no further processing.2
CDN Domain Prefix
If a
cdn_url is configured in settings → the path is prefixed with the CDN domain.3
Amazon S3 Disk
If
image_s3 = 1 → the image is resolved via the S3 disk, using either global credentials or custom per-product credentials.4
Local Public Disk
Otherwise → the image is resolved via the standard local
public disk.Direct URL Image Source
Each image set carries animage_url_source flag. When this flag is enabled:
- Stored paths are treated as direct external URLs (e.g. CDN, third-party image hosts)
- The “Enter Image URLs” toggle in the add-set form switches the input between file upload mode and URL entry mode
- Existing image sets using URL mode display an amber “Direct URL” badge in the admin image list
Direct URL mode saves disk space and bandwidth — no file is downloaded or stored locally. Make sure the external URL is publicly accessible and stable.
Recommended Image Orientations
Site Store Pro supports two common product image aspect ratios. Choose the orientation that best matches your storefront layout template:Image Alt Text & Zoom Description
Image Status Badges
In the admin variant image list, each image set displays status badges for:- Search — the image that will show in search results, lists, etc to the public
- Active — green badge for visible images
- Inactive — grey badge for hidden images
Cross-Selling Panel
Access the cross-selling panel via the quick-nav bar at the top of the product edit page.1
Search for Products
Use the live search input (debounced at 400ms) to find products by title or product ID. Results appear in a dropdown as you type.
2
Add Cross-Sell Items
Click a search result to add it to the cross-sell list. A product can have a maximum of 10 cross-sell items.
3
Configure Display Options
For each cross-sell entry, configure:
- Show on Product Page toggle (
display_on_item_view) — displays the cross-sell on the product detail page - Show on Post-Cart Page toggle (
display_on_post_cart) — displays the cross-sell on the post-add-to-cart confirmation page
4
Set Sort Order
Enter a numeric sort order for each cross-sell item to control the display sequence.
