Brand Feed

Provide a brand feed so Search can link brand results to landing pages and display brand metadata.

Provide a brand feed so Search can link brand results to your brand landing pages and display brand icons.

What Search uses the brand feed for

  • Forward users from search results directly to brand URLs (landing pages)
  • Display brand icons

Feed format

Use one <brand> element per brand inside the <perselio_brand_feed> root element.

<?xml version="1.0"?>
<perselio_brand_feed>
    <brand>
        <id>100</id>
        <name>Puma</name>
        <url>https://www.eshop.com/puma/</url>
    </brand>
    <brand>
        <id>101</id>
        <name>Nike</name>
        <url>https://www.eshop.com/Nike/</url>
    </brand>
</perselio_brand_feed>

Field definitions

The same fields can also be used when you provide brand metadata directly in the item feed.

FieldTypeRequiredDescription
<id>stringYesUnique identifier for the brand.
<name>stringYesBrand name shown in Search.
<url>stringYesBrand landing page URL that Search opens when a user selects the brand result.
<image_url>stringNoBrand icon URL shown in Search.

How to use brand data in the item feed

You can provide brand data in two ways:

  1. Provide the full brand data directly in the item feed. This is usually fine for smaller catalogues, for example thousands of products and feed sizes in the low tens of MBs.
  2. Provide only the brand ID in the item feed and keep the full brand metadata in the brand feed. Consider this when the catalogue is large, for example 50k items or more and feed sizes above 30 MB.

Do not duplicate the same brand metadata in both feeds unless you have a specific reason to do so. Repeating brand names, URLs, and icons on every item can make the item feed larger and more expensive to download and synchronize.