# Create and Manage a Product ### PUQcloud Panel ##### [Order Now](https://puqcloud.com/puqcloud-panel.php) | [Download](https://github.com/puqcloud/PUQcloud) | [FAQ](https://faq.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903017354.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903047710.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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 content** — **Name**, **Short Description**, **Description** per language. - **Notes** — internal notes for admins. Click **Save**. *(Screenshot reference: Product → General tab)* [![image-1756903073473.png](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903073473.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903090331.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903104284.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903111741.png)](https://doc.puq.info/uploads/images/gallery/2025-09/image-1756903111741.png) **Edit a price** - Click the **Edit** icon on a row, adjust amounts, **Save**. [![image-1756903119210.png](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903119210.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903212627.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903218589.png)](https://doc.puq.info/uploads/images/gallery/2025-09/image-1756903218589.png) ##### 5) Options Link **option groups** like CPU, RAM, Disk to let customers configure variants during order. [![image-1756903301898.png](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903301898.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903308668.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903317194.png)](https://doc.puq.info/uploads/images/gallery/2025-09/image-1756903317194.png) [![image-1756903362963.png](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903362963.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756903370916.png)](https://doc.puq.info/uploads/images/gallery/2025-09/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.