Units¶

Purpose¶

Units define measurement standards for your products, helping customers understand product quantities clearly. Whether you sell by piece, weight (kilograms, pounds), volume (liters, gallons), or packaging (boxes, sets), units ensure accurate product representation and help customers make informed purchasing decisions.

Accessing Units¶

Navigate to: Catalog Management > Units from the sidebar menu
Units are assigned to products in the product creation/edit form

Units List View¶

Units List

The Units page showing all measurement units

Understanding the Units List¶

The units list displays all your defined measurement units in a simple table:

Name - The unit name as displayed to customers - Searchable for quick lookup - Supports multiple languages (Arabic/English) - Examples: "Piece", "Kg", "Liter", "Box", "Set"

Actions - Edit: Modify unit details - Standard management actions

List Features¶

Locale Switcher - Switch between Arabic and English - Manage unit names in different languages - Each locale has separate name field

Search Bar - Search units by name - Instant filtering - Helpful for finding specific units

Toggle Columns - Customize visible columns - Personalize your view - Show/hide additional information

Bulk Selection - Select individual units with checkboxes - Select all for bulk operations - Perform actions on multiple units at once

Bulk Actions Available: - Delete: Remove selected units - Export: Export unit data to file

New Unit Button - Click to create a new unit - Opens the unit creation form

Creating a New Unit¶

Click the "New Unit" button at the top right. The unit form is very simple:

Unit Creation Form

Unit creation form with name field

Name (Required)¶

The unit name as shown to customers
Must be filled before saving
Should be clear and universally understood
Can be full name or abbreviation
Examples: "Piece", "Kilogram", "Kg", "Liter", "L", "Box", "Dozen"

Naming Best Practices:

Option 1: Full Names - Clear and unambiguous - Better for customers unfamiliar with abbreviations - Examples: "Piece", "Kilogram", "Liter", "Box", "Dozen"

Option 2: Abbreviations - Shorter, saves space in product listings - Familiar to most customers - Examples: "Pc", "Kg", "L", "Lb", "Oz"

Option 3: Bilingual - Use English in one locale, Arabic in another - Automatic translation based on customer's language preference

Recommended Approach: - Use commonly recognized terms - Be consistent across all units - Consider your target audience's familiarity

Common Units by Category¶

Weight Units¶

Kilogram (Kg): Metric weight measurement
Gram (g): For lighter items
Pound (lb): Imperial weight measurement
Ounce (oz): For small weight items
Ton: For very heavy items

Volume Units¶

Liter (L): Metric liquid measurement
Milliliter (ml): For smaller volumes
Gallon: Imperial liquid measurement
Fluid Ounce (fl oz): For beverages

Count Units¶

Piece (Pc): Individual items
Dozen: 12 pieces
Pair: 2 pieces (shoes, gloves)
Set: Group of related items

Packaging Units¶

Box: Boxed products
Pack: Packaged items
Carton: Large packaging
Bundle: Grouped items
Case: Multi-item packaging

Length Units¶

Meter (m): Metric length
Centimeter (cm): Smaller lengths
Foot (ft): Imperial length
Inch (in): Smaller imperial length
Yard (yd): Fabric measurement

Area Units¶

Square Meter (m²): Metric area
Square Foot (ft²): Imperial area

Saving Your Unit¶

After entering the unit name:

Create: Save the unit and return to the list
Create & create another: Save and immediately create another unit
Cancel: Discard changes and return to the list

Editing Existing Units¶

To edit a unit: 1. Find the unit in the list 2. Click "Edit" or click directly on the unit name 3. Modify the name 4. Click "Save" to update the unit

Locale Management¶

Unit names support multiple languages: 1. Use the Locale dropdown at the top of the form 2. Switch to Arabic to enter Arabic unit name 3. Switch to English to enter English unit name 4. Each locale has a separate Name field

Translation Examples: - English: "Piece" → Arabic: "قطعة" - English: "Kilogram" → Arabic: "كيلوجرام" - English: "Liter" → Arabic: "لتر" - English: "Box" → Arabic: "صندوق" - English: "Set" → Arabic: "طقم"

Deleting Units¶

Important Considerations Before Deleting: - Check if products are using this unit - Products won't be deleted, but unit reference will be removed - Consider editing instead of deleting if products exist - Loss of unit information may confuse customers

To delete a unit: 1. Select the checkbox next to the unit(s) 2. Click "Delete" from the bulk actions 3. Confirm the deletion

Exporting Units¶

To export unit data: 1. Select the units you want to export (or select all) 2. Click "Export" from the bulk actions 3. Download the exported file

Use exports for: - Backup purposes - Documentation - Sharing with team members - Migration to other systems

Tips for Unit Management¶

Standard Units First: Create commonly used units before specific ones
Consistent Naming: Use the same format for all units (all full names or all abbreviations)
Customer Clarity: Choose unit names customers will understand immediately
Multi-language: Always provide names in both Arabic and English
Avoid Duplicates: Check existing units before creating new ones
Think Ahead: Create units you'll need for future products
Industry Standards: Use standard abbreviations when possible
Regional Preferences: Consider if your market uses metric or imperial
Product Context: Unit should make sense for the product type
Regular Review: Periodically review and clean up unused units

Unit Setup for Different Business Types¶

Grocery Store¶

Essential units: - Kilogram (Kg) - Gram (g) - Liter (L) - Piece (Pc) - Pack - Dozen

Clothing Store¶

Essential units: - Piece (Pc) - Pair - Set - Dozen (for bulk items)

Electronics Store¶

Essential units: - Piece (Pc) - Set (for multi-component products) - Pack (for accessories) - Box (for packaged items)

Hardware Store¶

Essential units: - Piece (Pc) - Kilogram (Kg) - Meter (m) - Box - Pack - Set (for tool sets)

Restaurant/Food Service¶

Essential units: - Kilogram (Kg) - Gram (g) - Liter (L) - Piece (Pc) - Portion

Unit Selection Best Practices¶

For Products¶

When assigning units to products, choose based on:

How Customers Buy: - If bought individually: "Piece" - If bought by weight: "Kg", "g", "lb" - If bought by volume: "L", "ml", "gal" - If bought in groups: "Pack", "Set", "Dozen"

Product Nature: - Solid items: "Piece", "Box", "Set" - Liquids: "Liter", "ml", "Gallon" - Bulk items: "Kg", "Ton" - Fabric/Cables: "Meter", "Yard"

Industry Standard: - Follow what competitors use - Match customer expectations - Use familiar measurements

Common Scenarios¶

Scenario 1: Setting Up a New Store¶

Create fundamental units first: Piece, Kg, Liter
Add packaging units: Box, Pack, Set
Include specialized units for your product types
Test by adding a few products to ensure units make sense

Scenario 2: Adding a New Product Type¶

Example: Adding fabric products to electronics store 1. Check if needed units exist (Meter, Yard) 2. Create new units if missing 3. Add both Arabic and English names 4. Assign to new products

Scenario 3: International Expansion¶

When expanding to markets with different measurement preferences: 1. Add equivalent imperial/metric units 2. Example: Add "Pound (lb)" alongside "Kilogram (Kg)" 3. Update product units based on target market 4. Keep both available for flexibility

Unit Quality Checklist¶

Before publishing a unit:

[ ] Unit name is clear and understandable
[ ] Name provided in both Arabic and English
[ ] Name follows consistent format with other units
[ ] Unit makes sense for intended product types
[ ] No duplicate units exist
[ ] Abbreviation (if used) is standard and recognizable

Relationship with Products¶

Units connect to products in the following way: - Each product can be assigned one unit - Unit appears next to product price and quantity - Helps customers understand product sizing - Used in cart and checkout displays - Appears on invoices and receipts

Product-Unit Examples: - "Samsung Galaxy S24 - 1 Piece" - "Olive Oil - 2 Liters" - "Sugar - 5 Kg" - "Screwdriver Set - 1 Set" - "White T-Shirt - 3 Pieces"

Troubleshooting Common Issues¶

Issue: Unit not appearing in product dropdown - Solution: Ensure unit is created and saved, refresh product page

Issue: Wrong language showing for unit - Solution: Switch locale and update the name field for that language

Issue: Duplicate units with different spellings - Solution: Delete duplicates, standardize naming, update affected products

Issue: Confusion between similar units - Solution: Use clear, distinct names; add context if needed (e.g., "Pack (6 units)")

Issue: Products showing unit in wrong language - Solution: Check product's assigned unit has name in both languages

By maintaining a well-organized unit system with clear, standardized names, you help customers understand exactly what they're purchasing!

Products - Product measurements
Item Attributes - Product attribute units