Goflow Documentation Logo

Understanding Listing Attribute Mapping

Attribute mapping links attributes on listing to fields in the product catalog. This allows product data to transfer from the product to the listing.

Store listings are distinct from products. The Goflow product catalog is the central hub where all product information is saved, while listings represent those products on channels according to each channel’s requirements. Listings are linked to products through listing mapping.

Attribute mapping is different from listing mapping. Listing mapping links one specific listing to one specific product, while attribute mapping connects product fields to listing attributes across all listings.

Completing listing attribute mappings enables these workflows:

Managing Listing Attribute Mapping

To manage listing attribute mapping, follow these steps:

  1. From the left sidebar, go to Directory › Stores, and open the store.
  2. On the Listing Attribute Mappings card, click Manage.
  3. Map each listing attribute on the left to its corresponding product field on the right.
  4. To add a new mapping, click Add Mapping.
  5. To add all attributes for a specific category, see Adding Category Attributes.
  6. To automatically create the required product fields, see Creating Custom Fields.
  7. Click Save to apply your mappings.

You do not need to map every available attribute. Mapped attributes will benefit from prefilling, while those left unmapped can be entered manually. Similarly, only mapped attributes will update on a synced listing, while unmapped attributes retain their static values.

Adding Category Attributes

Stores include general attributes that apply to all listings. In addition, there are thousands of category-specific attributes that you can add and map as needed. Follow these steps:

  1. On the Add Category Attributes card, search for a listing category.
  2. Click the Select Attributes button.
  3. The Category Attributes window displays all the required and optional attributes for the selected category.
  4. Check the attributes you want to add, or click Select All.
  5. Click Add Attributes at the bottom of the window.

Creating Custom Fields

Standard product fields cover general attributes that apply across all products. To map category-specific attributes, create new product custom fields. Goflow helps streamline this process by suggesting the custom fields you need based on the selected attributes. Follow these steps:

  1. On the Create Custom Product Fields card, click the Configure Custom Fields button.
  2. The Product Custom Fields window opens with the recommended fields prefilled, including the field name, data type, and whether the field supports multiple values.
  3. Accept the suggested settings or modify them to match your needs.
  4. Click Create Custom Fields at the bottom of the window.

The newly created custom fields are automatically mapped to their corresponding listing attributes.