Skip to main content

Product Pages

Every product in your catalog can be configured with customer-facing content through the product editor's Web Editor tab. This content powers your online storefront product detail pages.

Accessing the Web Editor

  1. Navigate to Products and open any product for editing.
  2. In the product editor header, click Web Editor (toggles between Item Fields and Web Editor views).
  3. The Web Editor panel shows the online content fields.

Web Editor Fields

Online Short Description

A concise summary shown in product cards, menu listings, and search results. Supports rich text formatting (bold, italic, headings, lists).

  • Where it appears: Product card previews, menu section listings, and as a fallback for the page's meta description.
  • SEO impact: Used as the meta description if metaDescription is empty.

Online Description

The full product description shown in the expandable Description panel on the product detail page. Supports rich text formatting.

  • Where it appears: Product detail page, accordion Description section.
  • SEO impact: Last-resort fallback for the page's meta description (HTML is stripped).

Meta Tags

Comma-separated tags rendered as clickable chips on the product detail page. Clicking a chip navigates to other products sharing that tag.

  • Where it appears: Chip display below product info; drives the "Related Products" section.
  • SEO impact: Pushed into <meta name="keywords"> on the product page.

Slug

A URL-friendly identifier for the product. Used to build clean, readable product URLs.

Material Icon

An optional icon identifier (from Material Icons) that can appear alongside the product in listings.

Web Visibility Toggle

In the product editor's toggle section (visible in Item Fields view), the Web Enabled toggle controls whether the product appears in the online storefront.

StateEffect
On (webProduct = true)Product is visible in the online catalog
Off (webProduct = false)Product is hidden from the online catalog

A product must be both Active and Web Enabled to appear in the storefront.

Product Images

Product images are uploaded through the image list uploader in the product editor. The workflow:

  1. Click the image uploader in the product editor.
  2. Select or capture images (mobile camera capture is available on phones).
  3. Images are cropped, converted to WebP, and uploaded to Amazon S3.
  4. The first image becomes the main/hero image; additional images appear in the gallery.

On the product detail page, images render in an interactive gallery with lazy loading.

Dimensions and Shipping

The Web Editor's Dimensions / Weight tab captures:

  • Product dimensions — height, width, depth, weight (units depend on your API configuration).
  • Shipping dimensions — shipping length, width, height, weight in ounces.

Shipping dimensions are used when calculating shipping costs for online orders.

Property Groups

The Property Groups tab lets you copy attribute groups from another product or define custom property sets. These appear on the product detail page and can influence WordPress visibility when the WordPress plugin is active.

Group Props Display

For cannabis products, groupProps render on the product detail page showing strain attributes (terpene profiles, effects, flavors). The chemical spinners (THC/CBD visualizers) appear alongside group props for cannabis item types.

Special Description

An optional secondary description that renders in its own "Special" accordion panel on the product detail page. Only shown when content exists.

Ingredients Panel

For cannabis, food, alcohol, grocery, and tobacco item types, an "Ingredients" accordion panel appears on the product detail page showing chemical compositions and ingredient data.

What Customers See

A fully configured product page displays:

  1. Image gallery — hero image + gallery carousel
  2. Product name (H1)
  3. Species badge (cannabis: Indica/Sativa/Hybrid)
  4. Brand / company name
  5. Color and country of origin
  6. Group props (strain attributes)
  7. Short description (above the fold)
  8. Barcode / SKU and stock count
  9. Matrix variants (size/color options, if applicable)
  10. Pricing — retail price, tier pricing, or weight-based pricing
  11. Add to Cart button with quantity selector
  12. Meta tag chips (clickable filters)
  13. Packaging selector (if packaging materials are configured)
  14. Portion value dropdown (if applicable)
  15. Prep notes textarea (if custom notes are enabled)
  16. Description accordion (full online description)
  17. Instructions (if item type has instructions)
  18. File attachments (if files are attached)
  19. Special accordion (if special description exists)
  20. Ingredients accordion (for regulated item types)
  21. Related products — items bought recently together, you-might-also-like, and meta-tag matches

WordPress Visibility Indicator

When the WordPress plugin is active (see WordPress Integration), the product editor shows a visibility bar:

  • Green "Visible in WordPress" — the product meets all sync requirements (has a barcode, sufficient inventory, webProduct is enabled).
  • Warning "Not visible in WordPress" — lists the specific reasons (missing barcode, low inventory, etc.).