A+ Brand Story Modules

Learn how to manage Brand Story Content modules with the A+ Content API.

Brand Story content appears on the Product Detail Page (PDP) under the "From the Brand" heading — a dedicated space completely separate from your product-level A+ Content. Brand Story enables you to tell your brand's unique story, build brand awareness, and cross-sell other products in your catalog.

Features

Carousel display with full-screen background on desktop and mobile devices
Image and text cards
Links to other products and your Amazon Brand Store

Brand Story is meant to complement A+ Content; while Premium Content focuses on product features to drive sales, Brand Story expands the customer's knowledge of your brand and provides cross-sell opportunities. We recommend using both together to maximize your brand's presence on the PDP.

Note

To create Brand Story content, set contentType to BrandStory and include Brand Story module definitions in the contentModuleList array. Brand Story modules cannot be combined with Standard or Premium modules in the same content document.

Module reference

The following sections provide the full schema definition for each Brand Story module.

`BrandStoryImageWithLogoModule`

"contentModuleType": "BRAND_STORY_IMAGE_WITH_LOGO"

The required background card for all Brand Story content. Provides a full-width background image with a brand logo overlay, headline, and body text. All other Brand Story modules appear within this carousel.

Recommended use cases:

Establish your brand identity with a background image and logo

This is a required module. Every Brand Story document must include exactly one BrandStoryImageWithLogoModule as the background hero card. It serves as the carousel's full-width backdrop and cannot be omitted.

Fields

Field	Type	Required	Constraint	Description
`title`	`TextComponent`	Optional	value: max 30 chars	Brand headline overlaid on the hero image.
`description`	`ParagraphComponent`	Optional	textList: max 3 rows; total ≤ 135 chars	Short brand description text overlaid on the hero image.
`desktopImage`	`ImageComponent`	Required	min 1464w × 625h px	Full-width hero background for desktop.
`mobileImage`	`ImageComponent`	Required	min 463w × 625h px	Hero background for mobile devices.

Example

{
  "contentModuleType": "BRAND_STORY_IMAGE_WITH_LOGO",
  "brandStoryImageWithLogo": {
    "mobileImage": {
      "imageCropSpecification": {
        "offset": {
          "y": {
            "value": 0,
            "units": "pixels"
          },
          "x": {
            "value": 560,
            "units": "pixels"
          }
        },
        "size": {
          "width": {
            "value": 800,
            "units": "pixels"
          },
          "height": {
            "value": 1080,
            "units": "pixels"
          }
        }
      },
      "uploadDestinationId": "aplus-media/67f25fcc-8c12-443a-84f5-beccc6d3c1cb.png",
      "altText": "Descriptive text about the image"
    },
    "title": {
      "decoratorSet": [],
      "value": "Our Family"
    },
    "description": {
      "textList": [{
        "decoratorSet": [],
        "value": "We love our dogs and are really excited to share our family with you."
      }]
    },
    "desktopImage": {
      "imageCropSpecification": {
        "offset": {
          "y": {
            "value": 130,
            "units": "pixels"
          },
          "x": {
            "value": 0,
            "units": "pixels"
          }
        },
        "size": {
          "width": {
            "value": 1920,
            "units": "pixels"
          },
          "height": {
            "value": 820,
            "units": "pixels"
          }
        }
      },
      "uploadDestinationId": "aplus-media/67f25fcc-8c12-443a-84f5-beccc6d3c1cb.png",
      "altText": "Descriptive text about the image"
    }
  }
}

`BrandStoryFourAsinModule`

"contentModuleType": "BRAND_STORY_FOUR_ASIN"

A Brand Story card displaying up to four product ASINs with images, enabling cross-selling to other products in your catalog.

Recommended use cases:

Highlight products or other product lines from your brand
Drive cross-selling by linking to other Product Detail Pages

Fields

Field	Type	Required	Constraint	Description
`title`	`TextComponent`	Required	value: max 30 chars	Card headline displayed above the ASIN grid.
`brandStoreId`	`TextComponent`	Optional	value: max 100 chars	Brand Store identifier. Links the card to the brand's storefront.
`asinImages` (exactly 4 items)	array	Required		Array of ASIN image cards. Must contain exactly 4 items.
`productImage`	`ImageComponent`	Required	min 166w × 182h px	Product image for this ASIN card.
`productAsin`	`TextComponent`	Required	value: exactly 10 chars	Amazon product ASIN. Exactly 10 alphanumeric characters.

Example

{
  "contentModuleType": "BRAND_STORY_FOUR_ASIN",
  "brandStoryFourAsin": {
    "asinImages": [{
        "asinImage": {
          "productAsin": {
            "decoratorSet": [],
            "value": "ASINASIN01"
          },
          "productImage": {
            "imageCropSpecification": {
              "offset": {
                "y": {
                  "value": 0,
                  "units": "pixels"
                },
                "x": {
                  "value": 208,
                  "units": "pixels"
                }
              },
              "size": {
                "width": {
                  "value": 985,
                  "units": "pixels"
                },
                "height": {
                  "value": 1080,
                  "units": "pixels"
                }
              }
            },
            "uploadDestinationId": "aplus-media/1b94765b-f0d9-4416-bbdc-95f2d7bec345.png",
            "altText": "Descriptive text about the image"
          }
        }
      },
      {
        "asinImage": {
          "productAsin": {
            "decoratorSet": [],
            "value": "ASINASIN02"
          },
          "productImage": {
            "imageCropSpecification": {
              "offset": {
                "y": {
                  "value": 0,
                  "units": "pixels"
                },
                "x": {
                  "value": 467,
                  "units": "pixels"
                }
              },
              "size": {
                "width": {
                  "value": 985,
                  "units": "pixels"
                },
                "height": {
                  "value": 1080,
                  "units": "pixels"
                }
              }
            },
            "uploadDestinationId": "aplus-media/adf0687c-4f5b-4cfb-b660-fdc2e3311b45.png",
            "altText": "Descriptive text about the image"
          }
        }
      },
      {
        "asinImage": {
          "productAsin": {
            "decoratorSet": [],
            "value": "ASINASIN03"
          },
          "productImage": {
            "imageCropSpecification": {
              "offset": {
                "y": {
                  "value": 0,
                  "units": "pixels"
                },
                "x": {
                  "value": 467,
                  "units": "pixels"
                }
              },
              "size": {
                "width": {
                  "value": 985,
                  "units": "pixels"
                },
                "height": {
                  "value": 1080,
                  "units": "pixels"
                }
              }
            },
            "uploadDestinationId": "aplus-media/812ca5bb-16f3-466d-891c-464fbd7bd8ad.png",
            "altText": "Descriptive text about the image"
          }
        }
      },
      {
        "asinImage": {
          "productAsin": {
            "decoratorSet": [],
            "value": "ASINASIN04"
          },
          "productImage": {
            "imageCropSpecification": {
              "offset": {
                "y": {
                  "value": 0,
                  "units": "pixels"
                },
                "x": {
                  "value": 507,
                  "units": "pixels"
                }
              },
              "size": {
                "width": {
                  "value": 985,
                  "units": "pixels"
                },
                "height": {
                  "value": 1080,
                  "units": "pixels"
                }
              }
            },
            "uploadDestinationId": "aplus-media/0eda7aa0-8d41-496b-9937-486ea495cb9a.png",
            "altText": "Descriptive text about the image"
          }
        }
      }
    ],
    "brandStoreId": {
      "decoratorSet": [],
      "value": "my-brand-store-id-36chars00000000000"
    },
    "title": {
      "decoratorSet": [],
      "value": "Stop by our Dog Store!"
    }
  }
}

`BrandStoryMediaAssetModule`

"contentModuleType": "BRAND_STORY_MEDIA_ASSET"

A Brand Story card featuring a single image as the primary visual element.

Recommended use cases:

Showcase brand imagery
Spotlight featured/new products in your brand

Fields

Field	Type	Required	Constraint	Description
`title`	`TextComponent`	Optional	value: max 30 chars	Card headline displayed above the image.
`description`	`ParagraphComponent`	Optional	textList: max 3 rows; total ≤ 135 chars	Short description text displayed below the title.
`image`	`ImageComponent`	Required	min 362w × 453h px	Focus image for the card.

Example

{
  "contentModuleType": "BRAND_STORY_MEDIA_ASSET",
  "brandStoryMediaAsset": {
    "title": {
      "decoratorSet": [],
      "value": "Our Brand Dogs"
    },
    "description": {
      "textList": [{
        "decoratorSet": [],
        "value": "We love to spoil our dogs, we'd love to spoil yours too!"
      }]
    },
    "image": {
      "imageCropSpecification": {
        "offset": {
          "y": {
            "value": 0,
            "units": "pixels"
          },
          "x": {
            "value": 0,
            "units": "pixels"
          }
        },
        "size": {
          "width": {
            "value": 800,
            "units": "pixels"
          },
          "height": {
            "value": 1000,
            "units": "pixels"
          }
        }
      },
      "uploadDestinationId": "aplus-media/67f25fcc-8c12-443a-84f5-beccc6d3c1cb.png",
      "altText": "Descriptive text about the image"
    }
  }
}

`BrandStoryAboutModule`

"contentModuleType": "BRAND_STORY_ABOUT"

A Brand Story card with text-focused content for telling your brand's story, mission, or values.

Recommended use cases:

Share your brand's origin story or mission
Communicate what sets your brand apart from competitors

Fields

Field	Type	Required	Constraint	Description
`logoImage`	`ImageComponent`	Required	min 315w × 145h px	Brand logo image.
`title`	`TextComponent`	Optional	value: max 30 chars	Brand name or short heading.
`slogan`	`ParagraphComponent`	Optional	textList: max 10 rows; total ≤ 450 chars	Brand description or slogan text.

Example

{
  "contentModuleType": "BRAND_STORY_ABOUT",
  "brandStoryAbout": {
    "slogan": {
      "textList": [{
        "decoratorSet": [],
        "value": "Henry was our very first rescue, he welcomes all our other pups into the house. He's always
exploring the kitchen floor for leftovers."
      }]
    },
    "title": {
      "decoratorSet": [],
      "value": "Henry"
    },
    "logoImage": {
      "imageCropSpecification": {
        "offset": {
          "y": {
            "value": 98,
            "units": "pixels"
          },
          "x": {
            "value": 0,
            "units": "pixels"
          }
        },
        "size": {
          "width": {
            "value": 1920,
            "units": "pixels"
          },
          "height": {
            "value": 884,
            "units": "pixels"
          }
        }
      },
      "uploadDestinationId": "aplus-media/0aaabac1-d13e-4ca4-8f2a-2bb4e6b3d49d.jpeg",
      "altText": "Descriptive text about the image"
    }
  }
}

`BrandStoryQuestionsModule`

"contentModuleType": "BRAND_STORY_QUESTIONS"

A Brand Story card with question-and-answer pairs about your brand.

Recommended use cases:

Answer up to 3 common questions about your brand
Address brand-level concerns (e.g., sustainability, sourcing)

Fields

Field	Type	Required	Constraint	Description
`questionAnswerPairs` (exactly 3 items)	array	Required		Array of question/answer pairs. Must contain exactly 3 items.
`question`	`TextComponent`	Optional	value: max 70 chars	The question text.
`answer`	`ParagraphComponent`	Optional	textList: max 3 rows; total ≤ 200 chars	The answer text.

Example

{
  "contentModuleType": "BRAND_STORY_QUESTIONS",
  "brandStoryQuestions": {
    "questionAnswerPairs": [{
        "questionAnswerPair": {
          "question": {
            "decoratorSet": [],
            "value": "How did we get our start?"
          },
          "answer": {
            "textList": [{
              "decoratorSet": [],
              "value": "We started as a small family operation since we found our passion in rescue."
            }]
          }
        }
      },
      {
        "questionAnswerPair": {
          "question": {
            "decoratorSet": [],
            "value": "Why do we love what we do?"
          },
          "answer": {
            "textList": [{
              "decoratorSet": [],
              "value": "We love being a part of the pack and getting to spend time with them every day."
            }]
          }
        }
      },
      {
        "questionAnswerPair": {
          "question": {
            "decoratorSet": [],
            "value": "What problem are we solving?"
          },
          "answer": {
            "textList": [{
              "decoratorSet": [],
              "value": "We're providing quality products and developing support systems for rescues across the
country."
            }]
          }
        }
      }
    ]
  }
}

Updated about 1 hour ago