Goflow Documentation Logo

Managing Listing Attributes in Bulk

Update and manage listing attributes efficiently using CSV uploads. Whether you're working with standalone listings or variation listings, one listing or multiple listings, Goflow makes it simple to update listing attributes in bulk.

Bulk attribute updates is supported for the following channels:

This upload is intended for updating attributes on existing listings only. To create new listings in bulk, select the products on the page. Once the listings are created, even with nothing else but a SKU, you can use this upload to complete the remaining attributes and publish the listings with the store.

Synced listings are managed in bulk by updating the mapped product fields using a different file upload. Direct updates to mapped attributes on synced listings will be rejected.

SKU, Varies-By, and Images cannot be updated in bulk.

To update listing attributes using a file, follow these steps:

  1. From the sidebar navigation, go to Listings › Listings.
  2. At the top of the page, click the import icon and select Import Listing Attribute Updates.
  3. Select the store.
  4. On the Template tab, select the listing category. If the desired category is not displayed, click Refresh Categories.
  5. Select the attributes to update.
  6. Download a CSV file template with the selected attribute headers.
  7. Fill the template file with attribute information.
  8. On the Upload tab, make your selections for import options
  9. Upload the file by clicking the Choose File button.
  10. Downalad and review the feedback files.

Selecting Listing Attributes to Update

Each listing in the upload file must include at least one identifier header that specifies the listing being updated. You can use either SKU or Listing ID as the identifier. The identifier itself cannot be updated — it serves only as a reference to locate the listing.

The remaining headers in the file represent listing attributes. Include only the attributes you wish to update. To create a file with headers customized to your needs, start by selecting a category. This ensures the attributes provided are relevant, as attributes vary significantly between categories. Next, select the desired attributes from the list.

Attributes are grouped into two sections:

Before a cateogry is selected, the list displays general attributes for the selected channel. When selecting multiple categories, the list includes all attributes applicable to any of the selected categories. Some attributes may not apply to every listing in your file. For clarity and simplicity, it is recommended to select and work with one category at a time.

Downloading the Template File

After selecting the desired attributes, click the Download CSV Template button to get a file with the desired headers.

To provide multiple values to attributes that support them, edit the CSV template by adding additional columns for each value. For instance, create multiple columns with the header Bullet Features to update a listing with several bullet features.

Filling Attributes on the File

On the Template tab, click the Download Attribute Details button to generate a supplementary file containing detailed information about each selected attribute. This file includes:

The attribute details download is specific to a single category. To download details for multiple categories, simply select multiple categories in the Template tab, and click the Download Attribute Details button. A separate file will be generated for each selected category.

Updating Variation Listing Attributes

When updating variations, the listings to include in the file depend on whether the attributes being updated are attached to the variation parent or the variation children.

Attribute association does not always align with whether an attribute applies to the entire variation family or to individual variations only. The classification of an attribute as belonging to either parent or child depends on the channel. Macy's treats most attributes as associated with the parent, while Target considers only the category to be a parent attribute.

Changing a parent attribute may render certain existing child attributes irrelevant and invalid. For example, changing the category to Wireless would render the Plug Type attribute invalid. Whether such updates to the parent are accepted or rejected depends on whether those child attributes are included in the file.

Understanding Import Options

Provide instructions to Goflow on how to process your file by addressing the following questions:

Handling Empty Values

You are not required to provide a value for every column in every row. You may update specific attributes only for certain listings while leaving others blank. Decide, however, how to handle listings that already have an existing attribute value, but that attribute was left out on the file.

This question applies only to the headers included in the file. Attributes not being updated at all will always remain unchanged.

If you choose to clear a required attribute, the update will fail validation. Whether the update proceeds is determined by the next question.

Clear Empty may cause the unintentional deletion of existing listing attributes. This action is permanent and cannot be undone.

Handling Invalid Values

Your file may contain invalid attribute values. Decide whether invalid values should be rejected during upload or just flagged for review and correction at a later time.

This question applies only to the headers included in the file. Attributes not being updated at all will never be validated. If an update causes another attribute to become invalid, the listing will simply move to Review. For example, if the Battery Type attribute is updated from Rechargeable to Non-Rechargeable, the Charging Time attribute becomes irrelevant and invalid.

The option to skip validation applies only to invalid values. Values of an invalid data type will always fail.

Handling Draft Listings

For draft listings included in the upload file, decide whether updates make the listings ready for publication or not.

If you choose to publish but the listings contain errors, the listings will move to Review.

Reviewing the Feedback File

After importing the listing updates, Goflow generates feedback files for download. These files detail how the updates were applied. There are two types of feedback files:

Success - This file contains the listings where updates were successfully applied. It includes:

Success means the requested updates were successfully applied. It does not necessarily indicate that the listing is active yet.

Failure - This file contains the listings where updates could not be applied. It includes:

Review the error reason, correct, and upload the file again. The following errors will cause a listing update to fail: