Skip to main content

Product Management

Product and category management with bulk import and inventory browser

This section

Product Management

Add, edit, and delete products with full control over pricing, categories, images, descriptions, stock, and job restrictions.

Features

  • Full CRUD: Create, read, update, and delete products from the admin panel
  • Category Filtering: Assign products to categories for organized browsing
  • Image System: Auto-detects item images from your inventory provider, or set custom image URLs
  • Search: Real-time search across all products in admin and customer views
  • Bulk Selection: Select multiple products for batch operations

Product Fields

FieldDescription
Product NameDisplay name shown in the shop UI
Item CodeInventory item name (e.g., bread, water)
PriceItem price (supports decimal values)
CategoryCategory assignment for filtering
Image URLCustom image URL (auto-detected from inventory if empty)
DescriptionItem description shown on hover/detail
Stock EnabledToggle per-item stock tracking
Stock AmountCurrent stock count (only when stock is enabled)
Item JobJob requirement for this specific item
Job GradeMinimum job grade required to purchase

Import from Inventory

Browse all items registered in your server's inventory system directly from the admin panel.

  1. Click Import from Inventory in the Products tab
  2. The modal loads all items from your active inventory provider
  3. Search and filter items, select the ones you want
  4. Click Import — items are added with their name, label, and image automatically

Supported inventory providers: ox_inventory, qb-inventory, ps-inventory, qs-inventory, codem-inventory, gfx-inventory, esx_inventoryhud

Bulk Import

Import multiple products at once using JSON format:

  1. Click Bulk Import in the Products tab
  2. Paste a JSON array of product objects
  3. Products are validated and imported

Category System

  • Create unlimited categories per shop
  • Each category has a name and optional image URL
  • Products are filtered by category in the customer-facing shop UI
  • Deleting a category unlinks its products (products remain but become uncategorized)

Job Restrictions

Products can be restricted to specific jobs and grades:

  • Item Job: Only players with this job can see and purchase the item
  • Job Grade: Minimum grade required within that job
  • Restricted items appear grayed out in the UI with an "Insufficient Permission" badge