> ## 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.

# Description Box Component

> Defines and validates the Description Box content displayed on QR Code landing pages. Commonly used to show detailed text blocks such as product information, event summaries, or promotional details.

## Overview

The **Description Box Component** provides a flexible way to display textual content across multiple QR Code categories.\
It supports rich text descriptions while maintaining consistent formatting through the **cardStyle** reference, allowing customization of layout, background, and spacing.

Use this component to include **short summaries**, **product overviews**, or **event descriptions** below the main content.

## Properties

| Property      | Type     | Required | Description                                                                             |
| :------------ | :------- | :------- | :-------------------------------------------------------------------------------------- |
| **text**      | `string` | ✅ Yes    | The main description text to display. Must be at least 10 characters long.              |
| **cardStyle** | `object` | No       | Reference to the Card Style Component for customizing background, padding, and borders. |

## Used In Categories

This component is used in the following QR Code categories:

* [Coupon](/guides/category-components/categories/coupon)
* [Dynamic Text](/guides/category-components/categories/dynamicText)
* [Dynamic VCard](/guides/category-components/categories/dynamicVCard)
* [Event](/guides/category-components/categories/event)
* [Product](/guides/category-components/categories/product)
* [Social Media (sMedia)](/guides/category-components/categories/sMedia)
* [Wedding](/guides/category-components/categories/wedding)

## Example Schema

<CodeGroup>
  ```json Schema theme={null}
  {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "definitions": {},
    "title": "Description box component",
    "description": "Validate description box component",
    "type": "object",
    "required": [
      "text"
    ],
    "additionalProperties": false,
    "properties": {
      "text": {
        "type": "string",
        "minLength": 10
      },
      "cardStyle": {
        "$ref": "style/card.json"
      }
    }
  }
  ```
</CodeGroup>

## Notes

* The `text` property **must contain at least 10 characters** to ensure valid descriptive content.
* The `cardStyle` reference supports customization for visual consistency across sections.
* Avoid using HTML inside the text field — use plain or formatted Markdown text if supported by the category.