The sample products
A fresh install comes with three sample products — a coffee mug, a book and a T-shirt with sizes and colours — so the storefront has something to show from the first minute. While they are in your catalogue, Solidshop → Products lists them above the product list with a button that moves them all to the trash. You can restore them from the trash (Filter Options → Select Status → Trashed), and emptying the trash deletes them for good. A sample product that has been ordered is left alone: it is part of your order history. The samples have no category, so the Products list shows Category: None for them until you give them one.
Create a category first
Every product you create needs a category. Go to Solidshop → Categories to create your first category (e.g. “T-Shirts”, “Electronics”, or just “General”). Categories can be nested to any depth.
A category that is still a product’s main category cannot be deleted, and neither can one whose subcategories are. Products in the trash count too. Joomla says how many products are in the way: move them to another category, or delete them, and the category can go. Products listed there only as an additional category do not hold it back.
Solidshop uses Joomla’s built-in category system (com_categories).
If you are familiar with Joomla articles, creating product categories works exactly
the same way.
Additional categories
A product has one main category and can also be listed in any number of additional categories. A pulse oximeter can sit under Diagnostics and show on the Home care page as well, without a second copy of the product. Choose them in the product form, under the main category.
The product then appears on each of those category pages and wherever a category is listed: the category filter and its counts, the Categories module’s tiles, the Products and Reviews modules set to a category, Smart Search’s Category filter, the catalogue API, and the category lists of the XML sitemap and llms.txt. A category that holds only additional listings gets its page and its tile like any other. With the Discount & Coupons plugin (version 1.1.0 or later), a discount set up for a category reaches it too: the Product Category rule, a Product level discount and the Fixed price per unit action all count the categories a product is also listed in.
The main category still decides everything else:
- The breadcrumb shows the main category, except when the product is opened from a menu item for one of its additional categories: a shopper who came in through a Home care menu item sees Home care in the trail, not Diagnostics as well. Without a menu item of its own, an additional category leaves the main category in the trail.
- Who can see the product. Its main category must be published and open to the visitor’s access level. An unpublished or restricted additional category hides only its own page and its listing of the product.
- Custom fields. Only fields assigned to the main category apply; a product listed in Gifts does not pick up the Gifts fields. The multi-category support proposed for Joomla articles applies the fields of every category an article is in; Solidshop keeps them to the main category on purpose, because the fields feed the product’s filters and Specifications tab.
- The URL. A product URL carries no category, so additional categories add no URL and do not change the canonical one.
- Admin permissions and the drag-and-drop order of the Products list.
To list many products in a category at once, tick them in the Products list and use Actions → Batch → Add to category, or Remove from category to take them out again. Their main categories do not change. The list shows a product’s main category with +2 after it when it has two additional ones; hover over or tab to the number to see their names. Filtering the list by a category finds the products listed there either way.
Giving a product one of its additional categories as its main category takes that one out of the additional list. Deleting a category removes it from every product’s additional categories; a category that is still a product’s main category cannot be deleted (see above).
Additional category or tag? Use an additional category when a product belongs on a second shelf of your category tree. For a list that comes and goes — “Black Friday”, “Gifts under $50”, “New arrivals” — use a tag and a tag listing.
Create a product
Navigate to Solidshop → Products → New. The product form has several sections:
Basic details
- Name — the product title shown to customers
- Alias — the product’s part of its URL, made from the name when you leave it blank. A product URL carries no category, so no two products in a store can share an alias: when another product already uses it, one in the trash included, Solidshop adds a number (
coffee-mug-2) and tells you on save. With multilingual content on, the rule applies per language, and a product set to All languages counts in every language. - Main category — the category the product belongs to. It decides the product’s breadcrumb, who can see it and which custom fields it has
- Additional categories — optional, other categories that list the product too; see Additional categories
- Product type — “Physical” for tangible goods (other types are available via add-on plugins — Downloadable is free; Service and Subscription are commercial). When creating a product you pick the type from a set of cards; on saved products it becomes a dropdown. Changing the type reloads the form so only the tabs relevant to that type are shown — for example, Downloadable products get a Downloads tab and no Shipping tab. Your unsaved edits are kept across the reload.
- Brand — optional, you can create new brands inline. Brands are managed under Catalog → Brands, where each one can carry a logo — that is what the Brands module prints in a “Shop by brand” band, and what the brand filter narrows the listing by.
- Summary — a short description shown in product listings
- Description — the full product description with rich text formatting
- Tags — free-form tags for filtering and search. A Products menu item can list every product with a tag, which turns a tag into a collection page such as “Black Friday”; see Tag listings.
Media
Drag and drop product images, videos, or 3D models straight onto the media area, or browse and upload them through the built-in media manager. Solidshop automatically generates thumbnails at four sizes (small 150px, medium 356px, large 800px, and extra-large 2000px). You can configure these sizes and the aspect ratio (square, portrait, landscape, or original) under Options → Media. The ratio applies to every generated size, from the thumbnail tiles up to the full-size image on the product page, and images are cropped to it as they are uploaded.
Changing a size or the ratio later does not touch the images already in the library, so the storefront would ask for files that were never written. Open the media manager instead: a notice counts the images still at the old sizes, and Regenerate images rebuilds them a batch at a time while the tab stays open. Images already at the current sizes are skipped, so a run that was interrupted picks up where it stopped when you start it again. The files at the old sizes stay on disk unless you tick the option to delete them, and that step asks for a second confirmation because it cannot be undone.
A large library is quicker to rebuild from the command line, where there is no execution limit and nothing to keep open:
php cli/joomla.php solidshop:media:regenerate
--dry-run reports what would be written without touching a file,
--force rewrites images that are already at the current sizes,
--prune deletes the files at sizes no longer configured, and
--store=<id> picks a store other than the master store.
Pricing
- Price — the selling price
- Original price — optional “was” price shown as a strikethrough
- Cost per item — what one unit costs you to buy or make, kept for your own records and never shown to customers
- Tax class — which tax class applies to this product, or use the store default
Inventory
- SKU — stock-keeping unit for your internal tracking
- Barcode — optional UPC/EAN
- Track quantity — enable to manage stock levels; Solidshop will prevent overselling. Defaults to on for Physical products and off for types without physical stock (Downloadable, Service, Subscription, Virtual) — you can still enable it on any type, e.g. a service with limited seats
- Quantity — current stock count (only shown when tracking is enabled)
- Limit to one per order — a shopper can buy one of this product in an order, whichever variant they pick. The product page shows no quantity box, the cart shows the quantity as text, and a second one is refused with a message. On by default for new Subscription products, because one paid line starts one subscription for its quantity: two in the cart would be one subscription for two people, not two subscriptions. Existing products are not changed
To set Limit to one per order on many products at once, filter the Products list (by product type, for instance), tick the products, click Actions → Batch and choose Yes (or No to lift the limit). The One Per Order CSV column does the same through import.
Shipping
This tab only appears for product types that ship (Physical).
- Weight — product weight in your store’s configured unit (kg or g), used for shipping rate calculations
Specifications
Facts about this product alone, one row each: a label and a value, such as Wattage: 60 W or Capacity: 350 ml. Add, remove and drag rows into order on the Specifications tab. The product page lists them in its Specifications tab, after any custom fields shown there, and the tab stays hidden when a product has neither.
- Plain text, shown exactly as typed. HTML is not interpreted, so
<5 mmreads as written and a pasted<b>shows as those three characters. Each part is one line; line breaks become spaces. - Limits: up to 50 rows, labels up to 100 characters, values up to 500. A row with a label and no value (or a value and no label) is not saved, and longer text is cut — either way a message after saving names the row.
- Specification row or custom field? A row is for a one-off fact on one product. For an attribute many products share, or one shoppers should filter on, create a custom field instead — a specification row is never used as a filter.
- Rows are also included in the product’s structured data, in site search, in the catalogue API and in the CSV export (one row per line in the Specifications column).
Translating. On a multilingual site, open Translations and
fill the Specifications box for the language, one row per line written
Label: Value. You can also paste two columns from a spreadsheet; a tab between
them works as the separator, and so does a CJK full-width colon (:). A
translation replaces the whole list, so a row you add in the default language later
does not appear in that language until you add it there too — the box shows how
many rows the default language has. Leave the box empty to show the default
language’s rows. A line that cannot be read is reported after saving, with its
language and line number, rather than dropped quietly.
SEO
- Meta description — the search engine snippet (max 160 characters)
- Page title — custom browser title (max 70 characters), with a live preview of how the result appears in a search engine listing
Publishing
- Status — Published, Unpublished, Archived, or Trashed
- Publish up / down — schedule when the product becomes visible
Options & variants
If your product comes in multiple versions (sizes, colours, materials), use the Options section of the product form.
- Add an option (e.g. “Size”) and define its values (e.g. S, M, L, XL).
- Add more options if needed (e.g. “Colour” with values Red, Blue, Black).
- Tick Generate variants and save — Solidshop creates all combinations automatically (e.g. “S / Red”, “S / Blue”, “M / Red”, etc.).
- Each variant can override the parent product’s price, SKU, barcode, weight, and stock quantity.
Option names are what storefront filters read. Name the same thing the same way across products — Colour everywhere, not Colour on some and Color on others — or list every spelling on the filter (a filter can read several names). Differences of case, spacing and punctuation do not matter: Colour, colour and Colour: are one name. The filter’s Values tab shows the spellings it has gathered.
Colour and image swatches
Each option has a Show values as setting that decides how shoppers pick a value on the product page:
- Text buttons (the default) — a row of buttons carrying the value names. Right for sizes, capacities, and materials.
- Colour swatches — a round chip per value, painted with a colour you pick next to the value. A value without a colour (say “Multi”) stays a text button.
- Image swatches — a thumbnail per value. Click the picker in front of
a value to upload a swatch image (a square close-up of the fabric, finish, or pattern works
best) or to pick one you uploaded before. Swatches live in the store’s own swatch
library under
files/shop/<store>/swatches, apart from product photos, so one “Navy” swatch serves every product that comes in navy. A value without a swatch borrows the image of a variant that has one, and falls back to a text button otherwise.
Whichever mode you choose, the value name is never lost: it appears next to the option name once the shopper picks it (“Colour: Navy”), on hover, and to screen readers. Switching an option between modes keeps the colours and images you have already set, so you can try a mode and switch back. Swatches are also carried by the CSV export and import and by the catalogue API.
Structured data
Every product page carries Schema.org structured data (JSON-LD) built from the product form, which search engines read to show a product’s price, stock and rating in their results. There is nothing to switch on.
- A product without variants is described as one
Productwith one offer. - A product with variants is described as a
ProductGroup, and each variant as a product of its own: its SKU, barcode, image, price and stock, and a link that opens the page with that variant already picked. - Prices are in your store’s currency, with or without tax the way your tax display setting shows them on the page. An Original price higher than the price is marked as the struck-through price of a sale.
- A Barcode is included as the product’s GTIN when it is a valid UPC, EAN, ISBN-13 or GTIN-14. Anything else, such as a code of your own for the warehouse, is left out.
- Options named Color (or Colour), Size, Material or Pattern, and any option shown as colour swatches, tell search engines how the variants differ. Other options still appear in each variant’s name.
- Custom fields set to Include in structured data are added as product properties — see Custom fields.
- Specification rows are always added as product properties, after the custom fields: every row is shown on the page, and structured data describes what the page shows.
Search engines expect each variant to have an identifier of its own, so give every variant its own SKU or barcode, and an image. To see what a search engine reads, test a product page with Google’s Rich Results Test.