Overview

When selling on Amazon through Akeneo Activation, you may encounter "Revert Value" errors after exporting your products. These errors occur when Amazon rejects a product update because a specific piece of information — such as a Brand Name or Product Category — conflicts with data currently locked in their catalog.

Without automated handling, a single conflicting field blocks your entire product update, including valid new titles, descriptions, and images, until you manually correct it.

With Automated Revert Value Resolution, Akeneo Activation detects these conflicts during the export process, temporarily replaces the conflicting value with Amazon's required value for that export, and automatically resubmits the product — so your other updates go live without manual intervention.

How it works

Amazon sometimes locks certain attribute values for a product in its catalog. If your Akeneo PIM attribute data differs from Amazon's locked record — even slightly — Amazon rejects the entire product update.

The types of attributes most commonly linked to revert value errors include:

• Product identity (e.g., UPC, SKU, Brand, Manufacturer)
• Product categorization (e.g., Product Category, Sub-Category, Browsenode)
• Shipping and financial (e.g., Product Dimensions, Cost Price)
• Legal (e.g., Hazardous Waste designation, Battery information)

The screenshot above shows an example Revert Value error in the Akeneo Activation reports, highlighting an attribute conflict between the PIM data and Amazon's locked catalog value.

The scenario

• Your goal: You want to update a product's Title and Image.
• The conflict: Your Brand Name is spelled "Acme Inc." while Amazon's locked record lists it as "Acme".
• The result: Amazon returns a Revert Value error and rejects the Title and Image updates as well.

The solution

When Automated Revert Value Resolution is enabled in Activation, the system:

1. Identifies the specific conflicting value Amazon requires and records it in the channel reports.
2. Replaces your conflicting value with Amazon's required value (for this specific export only — no changes are made to your PIM data).
3. Resubmits the product automatically so your critical updates (such as the new Title or Image) are accepted and published.

Summary of benefits

• Higher acceptance rates: More products go live without manual troubleshooting.
• Time savings: No need to dig through error logs for simple data conflicts.
• Full visibility: A clear record of exactly what data was submitted to Amazon, with detailed logs accessible directly in the reports.

Configuring the feature

The Automated Revert Value Resolution feature is optional and must be enabled within your Amazon channel settings in Activation.

1. In Activation, navigate to your Amazon Channel.
2. Click the Settings tab.
3. Locate the Error Handling section.
4. Enable the Automatically fix Revert Value Errors using suggested values toggle.

The screenshot above shows the Error Handling section within the Amazon channel Settings tab in Activation, with the Automatically fix Revert Value Errors toggle.

Reviewing results and reports

When Automated Revert Value Resolution triggers, Akeneo Activation provides full transparency into what data was sent to Amazon and what was changed.

Accessing the report

To review revert value resolutions for an Amazon channel export in Activation:

1. Open your Amazon Channel in Activation.
2. Go to the Reports tab.
3. Locate the relevant export job.
4. Click on the export to open its report details.

Understanding the inline report details

In the report detail view, each Revert Value entry shows a summary row with the product identifier and a description such as "Reverted → 3 subfields and resubmitted." Expanding the row reveals the following columns for each reverted attribute:

• Attribute: The specific attribute that caused the conflict (e.g., item_package_dimensions, brand_name).
• Original Value: The value you originally attempted to send from your PIM (e.g., "4.88 inches").
• Reverted Value: The value Amazon expected and that Activation used when resubmitting the product (e.g., "5.0 millimeters").
• Note: A confirmation that the error was temporarily fixed by reverting the attribute value to Amazon's accepted format, and that further action may be needed.

Downloadable revert value report

Each export that triggers the Automated Revert Value Resolution also generates a downloadable Revert Value Error Report (Excel format), accessible from the Generated Files button in the report detail view.

This report contains one row per reverted attribute and includes the following columns:

• PIM Identifier: Your internal product identifier from Akeneo PIM.
• SKU/EAN: The product's SKU or EAN submitted to Amazon.
• Marketplace Identifier: The Amazon-side product identifier.
• Product Type / Catalog: The product type or catalog used for the submission.
• Attribute in error: The attribute name that triggered the Revert Value error.
• PIM / Pushed Value: The value you originally pushed from your PIM.
• Reverted Value: The value Amazon required, used for the resubmission.
• Message: The raw error message returned by Amazon.