Skip to main content
The Products section of the Site Store Pro admin panel is your central workspace for building and maintaining your catalog. From the main listing at /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 at GET /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 to GET /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:
  • 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:
Use Supercode when you need to paste embed codes, custom HTML structures, or clean up generated markup. Changes sync back to the WYSIWYG view automatically when you close the source editor.

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 an image_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.
Site Store Pro supports two common product image aspect ratios. Choose the orientation that best matches your storefront layout template:
Maintain a consistent orientation across all image sets for a given product to avoid layout shifts in gallery and zoom views.

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.
Each product supports a maximum of 10 cross-sell items. Attempting to add an 11th item will be blocked by the form.

Product-Level Review Toggle

On the product edit page you can enable or disable the reviews system per product, independent of the global setting. See Product Reviews for full moderation documentation.