PUQ Mautic Skip to main content

Create and Manage a Product

This guide explains how to create, configure, and maintain Products in the PUQcloud Panel, including pricing, attributes, options, and module settings.


Overview

  • Path: Menu → Products → Products

  • You can: Create products, edit details, upload images, add prices, link attributes & option groups, choose a module, and control visibility/availability.

  • Who: Admins with product management permissions.

A Product is what your customers buy. Prices, options, and the provisioning module all live under the product.


Products List

From Products → Products you’ll see: Icon, Key, Visible, Active, Stock, Services, and actions (Edit, Delete). Use Search to filter.

(Screenshot reference: Products list view)

image-1756903017354.png

Actions

  • + Create — start a new product.

  • Edit — open the product tabs (General, Images, Pricing, Attributes, Options, Module).

  • Delete — remove the product (does not remove existing services already provisioned).


Create a Product

  1. Click + Create.

  2. Enter a unique Key (e.g., influxdb).

  3. Click Save — the product opens on the General tab for further setup.

(Screenshots: Create Product modal → Product General tab)

image-1756903047710.png


Configure the Product

Use the tabs across the top to complete setup.

1) General

Fields you’ll see:

  • Key — internal identifier (read-only after creation).

  • Hourly Billing — enable if the product can be charged hourly.

  • Allow Idle — allow an "idle" price tier.

  • Convert Price — auto-convert base currency rates to other currencies.

  • Cancellation Delay / Termination Delay (Hours) — grace windows before cancel/terminate executes.

  • Stock Control — enable and set quantity to track stock.

  • Hidden — hide from storefront/catalog.

  • Retired — prevent new purchases while keeping existing services.

  • Localized contentName, Short Description, Description per language.

  • Notes — internal notes for admins.
    Click Save.

(Screenshot reference: Product → General tab)

image-1756903073473.png

2) Images

  • Icon image — small logo shown in listings.

  • Background image — larger visual used on product pages/cards.
    Drag & drop or click to upload, then Save.

(Screenshot reference: Product → Images tab)

image-1756903090331.png

3) Pricing

The table shows Period, Currency, Setup, Base, Idle, Switch down, Switch up, Uninstall with Edit/Delete actions.image-1756903104284.png

 

Add a price

  1. Click + Add.

  2. Choose Currency and Period (One‑Time, Daily, Weekly, Bi‑weekly, Monthly, etc.).

  3. Enter amounts as needed (Setup, Base, Idle, Switch up/down, Uninstall).

  4. Save.image-1756903111741.png

Edit a price

  • Click the Edit icon on a row, adjust amounts, Save.

    image-1756903119210.png

 

4) Attributes

Attach predefined attributes that describe or parameterize the product (often used by modules or displayed to customers).

image-1756903212627.png

Add an attribute

  1. Open Attributes and click + Add Attribute.

  2. Pick an item from the dropdown list (e.g., proxmox-lxc-rootfs-raid10).

  3. Save.

image-1756903218589.png

5) Options

image-1756903301898.png

Add an option group

  1. Open Options and click + Add Option.

  2. Select a group (e.g., Firewall, Location, Additional Disk) and Save.

image-1756903308668.png

Manage option groups

  • Order — use the up/down arrows to change display order.

  • Edit — open the option group editor.

  • Hide/Show — toggle visibility for this product.

  • Unlink — detach the group from this product (confirm in the dialog).

image-1756903317194.png

image-1756903362963.png

6) Module

Choose the provisioning module and fill in any required fields. Each module exposes its own parameters.

  1. Go to Module.

  2. Pick the Module from the dropdown (e.g., PUQ Sample Product (active)).

  3. Complete the module fields.

  4. Click Save.

(Screenshot reference: Module tab)

image-1756903370916.png

 


Manage Visibility & Lifecycle

  • Set Hidden = On to keep the product out of public listings while you work.

  • Use Retired = On to stop new sales but keep existing services intact.

  • Control Stock to cap new orders when capacity is limited.


Best Practices

  • Start with Hidden while configuring; unhide only after pricing and module are ready.

  • Use clear, multilingual Name/Descriptions for customer understanding.

  • Keep Pricing consistent across currencies (use Convert Price if appropriate).

  • Keep option groups organized; put common groups (CPU/RAM/Disk) at the top.

  • Test a full order path with a sandbox client before going live.


Troubleshooting

  • Product not visible on site → Check Hidden and Retired toggles; ensure at least one Price exists.

  • Options missing at checkout → Verify the groups are linked and visible for this product.

  • Provisioning fails → Confirm Module is selected and all required fields are filled; review module logs.

  • Wrong currency shown → Check the Pricing table and Convert Price setting.