Announcement: You can find the guides for Commerce 7.5 and later on the new Elastic Path Documentation site. This Developer Center contains the guides for Commerce 6.13.0 through 7.4.1.Visit new site

This version of Elastic Path Commerce is no longer supported or maintained. To upgrade to the latest version, contact your Elastic Path representative.

Catalogs

Catalogs

Catalogs are located at the top of the product hierarchy. They define the SKU options and brands that they can contain. A catalog may also include assets, such as images.

Catalogs do not have any required dependencies. When a catalog is exported, the associated assets may be optionally exported as well.

Note: Elastic Path supports virtual catalogs, which can contain products from multiple catalogs. For the purpose of the Import-Export tool, virtual catalogs are the same as regular catalogs.

Sample XML: Catalogs

<catalogs>
<catalog>
    <code>SLRWORLDCATALOG</code>
    <type>virtual</type>
    <name>SLR World Virtual Catalog</name>
    <defaultlanguage>en</defaultlanguage>
</catalog>
<catalog>
    <code>SNAPITUP</code>
    <type>master</type>
    <name>Snap It Up Master Catalog</name>
    <languages>
        <language>en</language>
        <language>fr</language>
    </languages>
    <defaultlanguage>en</defaultlanguage>
	<cartitemmodifiergroups>
		<cartitemmodifiergroup>
            <code>allFieldTypes</code>
            <displayname>
                <value language="en">AllFieldTypes</value>
            </displayname>
		<!-- Cart item modifier fields are specified per product type.
			 Below is the list of all supported field types 
			 (boolean, decimal, integer, date, date-time, email, short text, single-select option, multi-select option
		-->
            <cartitemmodifierfields>
                <cartitemmodifierfield>
                    <code>allFieldTypes.boolean</code>
                    <type>Boolean</type>
                    <required>false</required>
                    <maxSize xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/commerce-legacy/>
                    <ordering>4</ordering>
                    <displayname>
                        <value language="en">Boolean</value>
                    </displayname>
                    <options/>
                </cartitemmodifierfield>
                <cartitemmodifierfield>
                    <code>allFieldTypes.integer</code>
                    <type>Integer</type>
                    <required>true</required>
                    <maxSize xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/commerce-legacy/>
                    <ordering>3</ordering>
                    <displayname>
                        <value language="en">Integer</value>
                    </displayname>
                    <options/>
                </cartitemmodifierfield>
                <cartitemmodifierfield>
                    <code>allFieldTypes.date</code>
                    <type>Date</type>
                    <required>true</required>
                    <maxSize xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/commerce-legacy/>
                    <ordering>6</ordering>
                    <displayname>
                        <value language="en">Date</value>
                    </displayname>
                    <options/>
                </cartitemmodifierfield>
                <cartitemmodifierfield>
                    <code>allFieldTypes.shortText</code>
                    <type>ShortText</type>
                    <required>true</required>
                    <maxSize>10</maxSize>
                    <ordering>1</ordering>
                    <displayname>
                        <value language="en">Short Text</value>
                    </displayname>
                    <options/>
                </cartitemmodifierfield>
                <cartitemmodifierfield>
                    <code>allFieldTypes.multiSelectOption</code>
                    <type>PickMultiOption</type>
                    <required>true</required>
                    <maxSize xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/commerce-legacy/>
                    <ordering>10</ordering>
                    <displayname>
                        <value language="en">Mulit Select Option</value>
                    </displayname>
                    <options>
                        <option>
                            <displayname>
								<value language="en">Multi Value 1</value>
                            </displayname>
                            <value>multiValue1</value>
                            <ordering>1</ordering>
                        </option>
                        <option>
                            <displayname>
								<value language="en">Multi Value 2</value>
                            </displayname>
                            <value>multiValue2</value>
                            <ordering>2</ordering>
                        </option>
                        <option>
                            <displayname>
								<value language="en">Multi Value 3</value>
                            </displayname>
                            <value>multiValue3</value>
                            <ordering>3</ordering>
                        </option>
                    </options>
                </cartitemmodifierfield>
                <cartitemmodifierfield>
                    <code>allFieldTypes.decimal</code>
                    <type>Decimal</type>
                    <required>false</required>
                    <maxSize xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/commerce-legacy/>
                    <ordering>2</ordering>
                    <displayname>
                        <value language="en">Decimal</value>
                    </displayname>
                    <options/>
                </cartitemmodifierfield>
                <cartitemmodifierfield>
                    <code>allFieldTypes.email</code>
                    <type>Email</type>
                    <required>true</required>
                    <ordering>8</ordering>
                    <displayname>
                        <value language="en">Email</value>
                    </displayname>
                    <options/>
                </cartitemmodifierfield>
                <cartitemmodifierfield>
                    <code>allFieldTypes.dateTime</code>
                    <type>DateTime</type>
                    <required>false</required>
                    <maxSize xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/commerce-legacy/>
                    <ordering>7</ordering>
                    <displayname>
                        <value language="en">Date Time</value>
                    </displayname>
                    <options/>
                </cartitemmodifierfield>
                <cartitemmodifierfield>
                    <code>allFieldTypes.singleOption</code>
                    <type>PickSingleOption</type>
                    <required>false</required>
                    <maxSize xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/commerce-legacy/>
                    <ordering>9</ordering>
                    <displayname>
                        <value language="en">Single Option</value>
                    </displayname>
                    <options>
                        <option>
                            <displayname>
								<value language="en">Single Value 1</value>
                            </displayname>
                            <value>singleValue1</value>
                            <ordering>1</ordering>
                        </option>
                        <option>
                            <displayname>
								<value language="en">Single Value 2</value>
                            </displayname>
                            <value>singleValue2</value>
                            <ordering>2</ordering>
                        </option>
                        <option>
                            <displayname>
								<value language="en">Single Value 3</value>
                            </displayname>
                            <value>singleValue3</value>
                            <ordering>3</ordering>
                        </option>
                    </options>
                </cartitemmodifierfield>
            </cartitemmodifierfields>
        </cartitemmodifiergroup>
	</cartitemmodifiergroups>
    <attributes>
        <attribute>
            <key>A01010</key>
            <name>Optical System / Prism System</name>
            <usage>Product</usage>
            <type>ShortText</type>
            <multilanguage>false</multilanguage>
            <required>false</required>
            <multivalue>false</multivalue>
            <global>false</global>
        </attribute>
...
    </attributes>
<categorytypes>
        <categorytype>
            <name>SnapItUp</name>
            <template>categoryTemplate</template>
            <assignedattributes>
                <attributekey>catDescription</attributekey>
                <attributekey>catImage</attributekey>
            </assignedattributes>
        </categorytype>
    </categorytypes>
    <producttypes>
        <producttype>
            <name>Digital Cameras (Multi SKU)</name>
            <template>guidedSkuTemplate</template>
            <assignedattributes>
                <attributekey>A00556</attributekey>
                <attributekey>A00551</attributekey>
            </assignedattributes>
            <defaulttaxcode>GOODS</defaulttaxcode>
            <multisku>
                <assignedskuoptions>
                    <skuoption>Color</skuoption>
                </assignedskuoptions>
                <assignedattributes/>
            </multisku>
            <nodiscount>false</nodiscount>
        </producttype>
...
<skuoptions>
        <skuoption>
            <code>GC_Theme</code>
            <name>
                <value language="en">Design</value>
                <value language="fr">Motif</value>
            </name>
            <skuoptionvalues>
                <skuoptionvalue>
                    <code>hummingbird</code>
                    <name>
                        <value language="en">Hummingbird</value>
                        <value language="fr">Hummingbird</value>
                    </name>
                    <image>hummingbird.jpg</image>
                    <ordering>20</ordering>
                </skuoptionvalue>
                <skuoptionvalue>
                    <code>berries</code>
                    <name>
                        <value language="en">Berries</value>
                        <value language="fr">Berries</value>
                    </name>
                    <image>berries.jpg</image>
                    <ordering>10</ordering>
                </skuoptionvalue>
            </skuoptionvalues>
        </skuoption>
...
</skuoptions>
<brands>
        <brand>
            <code>F00015</code>
            <name>
                <value language="en">Battery Technology</value>
                <value language="fr">Battery Technology</value>
            </name>
            <image>bti.png</image>
        </brand>
...
</brands>
</catalog>