What This Screen Does
This is where you add a new product to your shop. Think of it like filling out a product listing for an online store. You enter the product name, description, images, price, and inventory details. Once you save, the product becomes available for customers to browse and purchase (if you choose to make it visible in the shop).
How to Get There
Open the dashboard.
In the left-hand menu, click Product.
Click the + New Product button (or navigate to the “New product” page).
You are now on the Create Product screen.
Step-by-Step Guide
1. Fill In Product Information
This is the first section of the form. It covers the basics that customers will see.
Field | Required | What to Enter |
Product Name | Yes | The name of your product (e.g. “Protein Shake” or “Gym Towel”). |
Gym Availability | Yes | Select one or more gym locations that should have access to this product. Defaults to your currently selected gym. |
Short Description | No | A brief summary of the product. This is shown in product listings and previews. Keep it to a sentence or two. |
Full Description | Yes | A detailed description of the product shown on the product page. Use the rich-text editor to add formatting like bold text, lists, or links. |
Product Images | Yes | Upload one or more photos of the product. The first image will be used as the main thumbnail. Images are cropped to a square (1:1 ratio). You must upload at least one image. |
Uploading Images
Click the image upload area to select files from your computer.
You can upload multiple images at once.
To remove a single image, click the remove button on that image.
To remove all images, click Remove All.
Images are cropped to a square format automatically.
2. Set Up Inventory & Organization
This section helps you categorize the product and manage stock.
Field | Required | What to Enter |
Product Code | No | An internal reference code for the product (e.g. “PRD-001”). This is for your own records. |
SKU (Stock Keeping Unit) | No | A unique identifier used for inventory tracking (e.g. “SHAKE-VAN-500”). |
Initial Quantity | Conditional | The starting stock quantity. This field only appears when Enable Inventory Tracking is turned on. Required if tracking is enabled. |
Product Category | No | Select a category from the dropdown to organize your products (e.g. “Drinks”, “Apparel”). Categories must be created beforehand in the Product Categories section. |
Accounting Number | Yes | The account number used for bookkeeping and financial reporting. Enter a number greater than zero. |
Display Order | No | A number that controls where the product appears in listings. Lower numbers appear first. |
Product Tags | No | Add searchable keywords to help customers find the product. Type a tag and press Enter. You can add multiple tags. |
Toggles
Toggle | Default | What It Does |
Available in Online Shop | On | When enabled, customers can see and purchase this product in the online shop. Turn it off to hide the product from the shop while keeping it in the system. |
Enable Inventory Tracking | On | When enabled, the system tracks stock levels for this product. Turning this off will remove all prior inventory entries — a confirmation dialog will appear to warn you before proceeding. |
3. Configure Pricing & Tax
This section is where you set what the product costs.
Field | Required | What to Enter |
Selling Price | Yes | The price customers will pay. Enter a number (e.g. “29.99”). The currency symbol is shown automatically based on your chain settings. Must be greater than zero. |
Cost Price | Conditional | Your cost to acquire or produce this product. Used for profit calculations. Required when creating a new product or when inventory tracking is disabled. |
VAT Rate | Yes | Select the applicable tax rate from the dropdown. You must choose a valid VAT rate (it cannot be left unselected). |
4. Save
Click the Create button at the bottom-right of the form.
The system will:
Validate all your inputs.
Create the product record for each selected gym location.
Upload the product images to each created product.
Redirect you back to the previous page.
You will see a green “Create success!” notification at the bottom of the screen.
What Happens Behind the Scenes
You click "Create"
|
v
Form validates all fields (Yup schema)
|
v
API call: ProductsService.create({ body: formData })
|
v
One product record is created per selected gym location
|
v
API call (for each product): ProductsService.addImage({ id, files: [images] })
|
v
Product images are uploaded and attached to each product
|
v
Success notification appears ("Create success!")
|
v
You are redirected back to the previous page
Troubleshooting
“I filled everything in but the Create button does not work”
Double-check that all required fields are filled in. The form will not submit if anything is missing.
Look for small red error messages below the fields — they tell you exactly what needs to be fixed.
Make sure you have uploaded at least one product image.
Make sure you have selected at least one gym in the Gym Availability field.
Make sure the Selling Price is greater than zero.
Make sure you have selected a valid VAT Rate (not left blank).
“I do not see any categories in the dropdown”
Categories are loaded when the page opens. If the list is empty, it means no product categories have been created yet.
Go to the Product Categories section first and create at least one category.
If categories exist but the dropdown is empty, try refreshing the page — there may have been a loading issue.
“I do not see any gyms in the Gym Availability field”
You must have at least one gym or location set up in the system before you can create a product.
If you are new to the platform, set up a gym first under the Gym settings.
The field defaults to your currently selected gym. If nothing is selected globally, the list may appear empty.
“The Initial Quantity field is not showing up”
The Initial Quantity field only appears when Enable Inventory Tracking is turned on.
Check that the inventory tracking toggle is switched to the “on” position.
If you do not need to track stock levels, you can leave inventory tracking off and skip this field.
“I got an error after clicking Create”
A red error message will appear. Read it carefully — it usually explains what went wrong.
Common causes include: server timeout, network issues, or a duplicate product conflict.
If the error is unclear, try again. If it keeps happening, contact support with the error message.
“My product images did not upload”
Images must not exceed the maximum file size allowed by the system.
If the product was created but the images failed, go to the product’s edit page and upload them again.
Make sure your internet connection is stable — large images need time to upload.
“I turned off inventory tracking and lost my inventory data”
When you disable inventory tracking, the system warns you with a confirmation dialog that all prior inventory entries will be removed.
This action cannot be undone. If you accidentally confirmed, you will need to re-enable tracking and manually re-enter your stock quantities.
Always read confirmation dialogs carefully before proceeding.
“The currency symbol is wrong”
The currency is set automatically based on your chain settings (the default currency configured for your organization).
You cannot change the currency per product. If the symbol is incorrect, ask your administrator to check the default currency in the chain settings.
“I want to add the product to multiple gyms at once”
When creating a new product, use the Gym Availability multi-select field to choose all the gym locations that should carry this product.
The system will create a separate product record for each selected gym and upload the images to all of them.
After creation, each gym’s product can be managed independently from the edit screen.