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

# Social Sharing Component

> Enables visitors to share QR Code landing pages directly across social platforms or channels. Commonly used in Event, Product, and Coupon categories for audience engagement and reach expansion.

## Overview

The **Social Sharing Component** allows users to share a QR Code landing page via supported social networks such as **Facebook**, **Instagram**, **Twitter**, **WhatsApp**, and **Email**.

It provides a flexible, configurable schema to control which platforms appear and includes optional **event tracking** for click analytics — helping brands measure how users share or promote their QR campaigns.

Each share action can be individually tracked using the integrated [Event Tracking Component](/guides/category-components/components/event_tracking).

## Properties

| Property       | Type      | Required | Description                                                                                                                                         |
| :------------- | :-------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
| **headerText** | `string`  | No       | Heading text displayed above the social sharing icons. Max length: `50`.                                                                            |
| **facebook**   | `boolean` | No       | Enables or disables Facebook sharing.                                                                                                               |
| **whatsApp**   | `boolean` | No       | Enables or disables WhatsApp sharing.                                                                                                               |
| **instagram**  | `boolean` | No       | Enables or disables Instagram sharing (opens profile share intent).                                                                                 |
| **twitter**    | `boolean` | No       | Enables or disables Twitter/X sharing.                                                                                                              |
| **email**      | `boolean` | No       | Enables or disables sharing via email.                                                                                                              |
| **tracking**   | `array`   | No       | Extends the [Event Tracking](/guides/category-components/components/event_tracking) core schema to capture share-event analytics for each platform. |
| **formatting** | `object`  | No       | Style configuration for text and card layout — references `style/text.json` and `style/card.json`.                                                  |

## Used in Categories

This component is used in the following categories:

* [Coupon](/guides/category-components/categories/coupon)
* [Dynamic Text](/guides/category-components/categories/dynamicText)
* [Event](/guides/category-components/categories/event)
* [Product](/guides/category-components/categories/product)

## Schema

<CodeGroup>
  ```json Schema theme={null}
  {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "title": "Social Sharing component",
    "description": "Validate social sharing component schema",
    "type": "object",
    "required": [],
    "additionalProperties": false,
    "properties": {
      "headerText": {
        "type": "string",
        "maxLength": 50
      },
      "facebook": {
        "type": "boolean"
      },
      "whatsApp": {
        "type": "boolean"
      },
      "instagram": {
        "type": "boolean"
      },
      "twitter": {
        "type": "boolean"
      },
      "email": {
        "type": "boolean"
      },
      "tracking": {
        "type": "array",
        "description": "Extend event tracking core and add additional property. see: https://json-schema.org/understanding-json-schema/structuring.html#id5",
        "additionalItems": false,
        "items": {
          "allOf": [
            {
              "$ref": "event_tracking.json"
            },
            {
              "properties": {
                "name": {
                  "type": "string",
                  "enum": [
                    "facebook",
                    "whatsApp",
                    "twitter",
                    "email",
                    "instagram"
                  ]
                }
              },
              "required": [
                "name"
              ]
            }
          ]
        }
      },
      "formatting": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "textStyle": {
            "$ref": "style/text.json"
          },
          "cardStyle": {
            "$ref": "style/card.json"
          }
        }
      }
    }
  }
  ```
</CodeGroup>

## Notes

* The `tracking` array extends the base [Event Tracking Component](/guides/category-components/components/event_tracking), adding a `name` property to differentiate platforms.
* Each boolean field (`facebook`, `twitter`, etc.) toggles the visibility of that sharing option.
* Recommended header examples: `"Share this page"`, `"Invite friends"`, `"Spread the word"`.
* You can omit unneeded platforms — only `true` values will be rendered.
* Styling properties allow seamless theme alignment with the rest of the QR landing page.