Goflow Documentation Logo

Listing Attribute Mapping

In Goflow, the product serves as the central catalog type, which contains all the details about your items. Attribute mapping involves linking product fields to listing attributes, enabling data to transfer from the product to the listing.

It's important to distinguish attribute mapping from listing mapping. Listing mapping links a specific product with a specific listing, whereas attribute mapping connects product fields to listing attributes across all listings within a given store.

Mapping listing attributes simplifies the creation and management of listings by:

Creating and Managing Listing Attribute Mappings

To manage store listing attribute mapping follow these steps:

  1. From the sidebar navigation, go to DirectoryStores, and select the store.
  2. On the Listings Attribute Mappings card, click Manage.
  3. Make your changes, and Save.

The actions you can do in listing attribute mapping include:

Adding Listing Attributes

The store comes preconfigured with general listing attributes that apply to all listing categories. Due to the vast number of available attributes, not all are listed on this page by default. You'll need to add the specific attributes relevant to your categories.

To add a single category by name, simply click on Add Mapping.

To add all listing attributes for a specific category, follow these steps:

  1. On the Listing Attribute Mapping page, go to the Add Category Attributes card.
  2. Select the desired category, and click Select Attributes.
  3. Check the attributes you wish to add, or click Select All.
  4. Finally, click on Add Attributes at the bottom of the modal.

Mapping Listing Attributes to Standard Product Fields

After adding the listing attributes you plan to use, you can map them. To map a single attribute to an existing product field, simply fill in the product field next to the attribute.

You don't need to map all the available attributes. Map as many as you want. The attributes that were mapped will pull data from the product, while unmapped attributes will require manual input.

Mapping Listing Attributes to Custom Product Fields

Product standard fields only cover the general fields that apply to all products. Given the vast number of available attributes, not all corresponding product fields exist yet. You'll need to create the necessary product fields as custom fields. Goflow helps you create all the custom product fields needed to map the specific category attributes you've added:

  1. On the Listing Attribute Mapping page, go to the Create Custom Product Fields card.
  2. Click on Configure Custom Fields.
  3. The Create Custom Product Fields modal will display all added attributes that are not yet mapped.
  4. Check the listing attributes for which you want to create custom fields.
  5. Accept the Goflow suggested settings for each custom field, or edit them to meet your business policies.
  6. Finally, click Create Custom Fields.

The newly created custom fields are automatically mapped to their corresponding listing attributes. Remember to Save the mappings on the main Listing Attribute Mappings page.