Managing Brands

Last updated: December 16, 2025

Brands represent product lines, divisions, or sub-brands within a client organization. Each brand can have its own logo that appears on QR codes and in the mobile app.

Brand Hierarchy

Client
└── Brand (with logo)
    └── Campaign
        └── QR Code

Creating a Brand

  1. Navigate to Brands in the admin sidebar
  2. Click the New Brand button
  3. Select the parent client
  4. Fill in brand details
  5. Upload a logo (optional but recommended)
  6. Click Create

Brand Fields

Field Required Description
Client Yes The parent client organization
Name Yes Brand name
Logo No Brand logo image (PNG, JPG, SVG)
Description No Brief brand description
Website No Brand website URL
Status Yes Active or Inactive

Brand Logo

Brand logos can be embedded into QR codes for enhanced brand recognition.

Logo Requirements

Property Requirement
Formats PNG, JPG, SVG
Minimum Size 100x100 pixels
Maximum Size 2MB
Recommended Square aspect ratio, transparent background (PNG)
Logo in QR Codes

When a logo is embedded in a QR code, the system automatically uses high error correction (H level) to ensure the code remains scannable. The logo occupies 15-30% of the QR code center.

Managing Brand Assets

To update a brand's logo:

  1. Edit the brand
  2. Click the "Remove" button on the existing logo (if present)
  3. Upload a new logo
  4. Click Save

API Access

# List brands
GET /api/v1/brands

# Create brand with logo
POST /api/v1/brands
Content-Type: multipart/form-data

{
    "client_id": 1,
    "name": "Premium Products",
    "logo": [file upload],
    "status": "active"
}

# Update brand
PUT /api/v1/brands/{id}

# Delete brand
DELETE /api/v1/brands/{id}

Next Steps