> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Branding

> Defines the Company Branding Component, which displays brand visuals such as a logo or title. Commonly used in Coupon and Social Media (sMedia) QR Code categories to establish brand identity.

## Overview

The **Company Branding Component** allows you to display brand visuals such as a logo, title, and formatted text elements on QR Code landing pages.\
It ensures consistent brand presence across different QR Code categories and supports customization via **style components** for typography and card layout.

All brand images must use a valid HTTPS URL and conform to supported file formats.

## Properties

| Property       | Type     | Required | Description                                                                      |
| :------------- | :------- | :------- | :------------------------------------------------------------------------------- |
| **image**      | `object` | ✅ Yes    | Contains the brand image (e.g., company logo).                                   |
| **title**      | `string` | No       | Brand or company name displayed under or beside the image.                       |
| **formatting** | `object` | No       | Defines visual styles for text and card layout using style component references. |

***

### 🖼️ **Image Object**

| Sub-Property | Type     | Required | Description                                                                                                      |
| :----------- | :------- | :------- | :--------------------------------------------------------------------------------------------------------------- |
| **url**      | `string` | ✅ Yes    | Direct HTTPS link to the image file. Must be a valid URI ending with `.png`, `.jpg`, `.jpeg`, `.svg`, or `.gif`. |

***

### 🎨 **Formatting Object**

| Sub-Property  | Type     | Reference            | Description                                                               |
| :------------ | :------- | :------------------- | :------------------------------------------------------------------------ |
| **textStyle** | `object` | Text Style Component | Controls typography such as font size, weight, and alignment.             |
| **cardStyle** | `object` | Card Style Component | Controls layout attributes such as border, background color, and padding. |

## Used In Categories

This component is used in the following QR Code categories:

* [Coupon](/guides/category-components/categories/coupon)
* [Social Media](/guides/category-components/categories/sMedia)

## Example Schema

<CodeGroup>
  ```json Schema theme={null}
  {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "definitions": {},
    "type": "object",
    "required": [],
    "additionalProperties": false,
    "properties": {
      "image": {
        "type": "object",
        "required": [
          "url"
        ],
        "additionalProperties": false,
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "pattern": "^(https?://.*\\.(png|jpg|jpeg|svg|gif|PNG|JPEG|JPG|SVG|GIF))$"
          }
        }
      },
      "title": {
        "type": "string"
      },
      "formatting": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "textStyle": {
            "$ref": "style/text.json"
          },
          "cardStyle": {
            "$ref": "style/card.json"
          }
        }
      }
    }
  }
  ```
</CodeGroup>

## Notes

* The **image** URL must be publicly accessible over HTTPS.
* Supported image formats: `.png`, `.jpg`, `.jpeg`, `.svg`, `.gif`.
* **Formatting** is optional but recommended for visual consistency with other elements on the page.
* Avoid oversized images (recommended max: **1MB**) for faster loading times.
