> For the complete documentation index, see [llms.txt](https://hollow-peak.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hollow-peak.gitbook.io/docs/store/products.md).

# Products

The four product types, and every field on a product.

**Store → Products**

## The four types

Choose the type first — it changes what the rest of the form asks for.

| Type                 | For                          | Behaviour                                                       |
| -------------------- | ---------------------------- | --------------------------------------------------------------- |
| **Physical**         | Goods you post               | Has weight and stock; charged shipping                          |
| **Digital**          | Files you sell               | Delivered by authorised download after payment; no shipping     |
| **Service**          | Work you perform             | No stock, no shipping. Bought like anything else                |
| **Quote on request** | Anything individually priced | No price and no Add to Basket — shows an enquiry button instead |

## Core fields

| Field                | Notes                                                          |
| -------------------- | -------------------------------------------------------------- |
| **Name**             | Shown everywhere                                               |
| **Address**          | Derived from the name; editable                                |
| **SKU**              | Your own reference. Optional but useful                        |
| **Summary**          | One or two lines, shown on cards and in search                 |
| **Description**      | The full description. Rich text                                |
| **Price**            | In your store currency                                         |
| **Compare-at price** | Shown struck through, marking it on sale. Leave blank for none |

## Images

**Cover image** — used on cards and as the main product image.

**Gallery** — additional images on the product page.

Resize before uploading. A 4000px photograph shown at 600px wastes most of its bytes.

## Stock

For physical products:

| Setting                 | Effect                                   |
| ----------------------- | ---------------------------------------- |
| **Track stock**         | Off means always available               |
| **Stock**               | Units on hand                            |
| **Low-stock threshold** | Below this, the page warns “Only N left” |
| **Allow backorder**     | Lets it be bought at zero stock          |

Stock decrements when an order is placed, and is protected against overselling under simultaneous orders.

{% hint style="info" %}
Stock is **not** returned automatically on refund. Returned goods may not come back, or may come back damaged, so returning stock is a deliberate act.
{% endhint %}

## Variants

For options that change price or stock — sizes, editions, licence tiers.

Each variant has its own name, price and stock. The product page shows a picker, and out-of-stock variants are marked.

For options that change nothing, leave variants alone and describe them in the description.

## Digital files

For digital products, upload the files buyers receive.

{% hint style="info" %}
Files are stored on a **private disk** under randomised names and are never addressable by URL. Every download is authorised individually — see **Digital Downloads**.
{% endhint %}

The size limit follows `STORE_FILE_MAX_KB` and your PHP upload settings.

## Categories

Assign one or more. Products can appear in several.

## Publishing

| Status        | Meaning                                                                        |
| ------------- | ------------------------------------------------------------------------------ |
| **Draft**     | Invisible to everyone. No back door — a draft product cannot be reached by URL |
| **Published** | Live                                                                           |

**Featured** products can be pulled out by the Product grid block.

## SEO

Per-product title and meta description, falling back to the name and summary.

## Ordering

Drag to reorder. This is the “Featured” sort order in the shop.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hollow-peak.gitbook.io/docs/store/products.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
