{
  "_copyright": "Copyright (c) 2026, Salesforce, Inc., All rights reserved. For full license text, see the LICENSE.txt file",
  "$schema": "https://slds.lightningdesignsystem.com/schemas/uif-system.v1.json",
  "apiVersion": "1.0.0",
  "name": "BrandBand",
  "description": "Decorative full-width background band rendered behind page content, used to brand record, group, and user profile pages with a configurable height, image, and position.",
  "extensions": {
    "com.salesforce-ux": {
      "genReady": false
    }
  },
  "cssSource": "./brandBand.css",
  "styleApi": {
    "status": "stable",
    "ready": true
  },
  "structure": {
    "name": "brandBand",
    "restrict": [
      "div"
    ],
    "description": "Root brand-band element. Renders as a positioned container whose background image is painted via ::before and an optional fade scrim via ::after.",
    "attributes": {
      "static": {
        "class": "slds-brand-band"
      }
    },
    "modifiers": [
      {
        "name": "cover",
        "attribute": "class",
        "value": "slds-brand-band_cover",
        "description": "Sizes the background image to cover the band rather than repeat-x at its natural size."
      },
      {
        "name": "full",
        "attribute": "class",
        "value": "slds-brand-band_full",
        "description": "Stretches the band's background to fill 100% of the container height."
      },
      {
        "name": "bottom",
        "attribute": "class",
        "value": "slds-brand-band_bottom",
        "description": "Anchors the background image to the bottom edge of the band instead of the top."
      }
    ],
    "variants": [
      {
        "name": "size",
        "description": "Mutually exclusive fixed band heights.",
        "options": [
          {
            "value": "small",
            "class": "slds-brand-band_small",
            "description": "Short band height (default 6rem)."
          },
          {
            "value": "medium",
            "class": "slds-brand-band_medium",
            "description": "Medium band height (default 12.5rem)."
          },
          {
            "value": "large",
            "class": "slds-brand-band_large",
            "description": "Tall band height (default 18.75rem)."
          }
        ]
      },
      {
        "name": "image",
        "description": "Mutually exclusive background-image treatments. Omit to use the default brand image.",
        "options": [
          {
            "value": "none",
            "class": "slds-brand-band_none",
            "description": "Suppresses the band image while keeping the page background."
          },
          {
            "value": "group",
            "class": "slds-brand-band_group",
            "description": "Uses the group banner asset as the band background image."
          },
          {
            "value": "user",
            "class": "slds-brand-band_user",
            "description": "Uses the user profile banner asset as the band background image."
          }
        ]
      }
    ],
    "children": [
      {
        "name": "blank",
        "restrict": [
          "div"
        ],
        "description": "Inner blank fill that paints a neutral surface and clears the ::before/::after gradients of an enclosing brand band.",
        "attributes": {
          "static": {
            "class": "slds-brand-band_blank"
          }
        }
      }
    ]
  }
}