Akeneo's Control Z:
A Deep Dive into Akeneo's Product Version History

by George Dzuricsko
Monday, December 21, 2020

When you work on product data in the PIM, you probably have some concerns likeā€¦
What happens if I make a mistake?
What happens if the manufacturer changes its mind?
How can I find out who changed this piece of product data?

Rest easy, my reader.

Akeneo has both a history and restore option that helps you understand what changed and when as well as how to undo it.

Version history tracks the changes on various entities in Akeneo to show the history of changes to a product. This is incredibly valuable documentation for product changes that will help you preserve previous versions if you need.

Below is a view of a demo product on the version history. You can quickly see the number of versions, the author, what changed and when.

Want to roll back a change? Click restore. Voila.

Check out Akeneo's documentation on restore.

Feels like magic, but what happens in the back end? And what limitations come with this approach?

As of version 4.0, Akeneo stores previous versions of supported entities in the pim_versioning_version table in the database with the following fields:

Author: (username of the user who made the change)
resourceName: (Entity, in this case Product) But the full list is below:
resourceId: (id of the record in the relevant Entity db)
Snapshot: array of current values
Changeset: array of only changed values
Context: additional information on job/process that caused the change
Version: current number of revision to specific item
Logged_at: Timestamp of change
Pending: Answer Pending based on tech team

Akeneo stores Changeset and Snapshot as normalized PHP arrays in the database, which allows for easier PHP array comparisons. A drawback to this is additional processing to export data using JSON or some other data type from these columns requires converting it back to PHP and then to whatever type you need.

Common Pain Points Around Version History

There are some important limitations to version history.

Default Flexibility and REQUIRED Serenity settings:

Akeneo Cloud editions have a default version history length of 90 days. After that, a console command pim:versioning:purge --more-than-days 90 --no-interaction --force runs via cron job. You can change that on Flexibility, but not on Serenity. 90 days should be plenty, but it's something to consider when evaluating your PIM requirements. Be sure to discuss this in the early stages of evaluating the appropriate version of Akeneo.

Version history can get very large:

On a very large PIM implementation, the size of the version history table can very quickly take over most of your free space if you disable the version history table or do not properly plan for the size of your PIM server.

Internal Usage Only:

There is no natively supported export of audits for versioning, so you are limited to the individual entity view page. In other words, you can only view the history of a single product and cannot search with filters of a modified attribute. There are some possible customizations here that we can help you estimate and explore, but only if you are on the Flexibility platform.

Version History only supports the following entities:

  • a. Channel
  • b. Locale
  • c. Category
  • d. Group
  • e. Product
  • f. Model
  • g. Association Type
  • h. Attribute
  • i. Attribute Group
  • j. Family
  • k. Job Instance

The above list helps for any of these entities but excludes a few with some important implications. Reference Entities and Assets are not supported, meaning changes to those records will not have a rollback feature, user audit record, or any of the other version history features. For example, if you change which reference entity a product attribute is assigned, it will be viewable in the interface:

But if you change the label on the reference entity:

There is no way to show that change on the reference entity record or on the products that have that entity assigned. Assets behave in a similar way, where changes to the individual asset do not register a version history but will affect how assets are viewed downstream.

Have any additional questions? Feel free to reach out to us!

Sitation Blogs

Sitation's Platform Partners Dominate the Q2 2021 Forrester PIM Report
by Steve Engelbrecht

Salsify Buys Alkemics - Why It's a Big Deal (and Why Sitation is Excited About It!)
by Steve Engelbrecht

Unlock 2021 - Integrating Akeneo with ElasticSearch
by Steve Engelbrecht

Setting up the Akeneo Connector in Magento 2: Part 3 – Filtering the Import Data
by Matt Helm

Using Azure Blob Storage for Remote Asset Storage in your PIM
by George Dzuricsko

Akeneo Product Data Roadmap
by Tyler Parafinik

An Insider's Guide to Akeneo's Offerings
by Brad Johnson

Sitation Adds Akeneo Extension to Marketplace: Version History Export Command
by George Dzuricsko

Sitation is a 2021 "Triangle Tweener"
by Steve Engelbrecht

Akeneo PIM for Projects of Any Size: A Guide to Data Structures
by Christina Smithers

Meet Sitation at Akeneo Unlock 2021
by Sitation Staff

Akeneo: Requiring an SSL Connection with Elasticsearch using Apache
by Don Bales

Akeneo: Requiring an SSL Connection with Elasticsearch using XPack
by Don Bales

Setting up the Akeneo Connector in Magento 2: Part 2 - Running the Jobs
by Matt Helm

Content Creation Part One: How Focusing on Copy Elevates eCommerce Strategy
by Autumn Demonet

How to Choose Axis Attributes When Building Product Models in Akeneo
by Britney Bowen

Keeping It Real While Working Remotely
by Tamara McGuigan

How to Channel Your Inner PIM: Helpful Hints for Achieving Syndication Zen
by Rachel Maley

Setting up the Akeneo Connector in Magento 2: Part 1 - Initial Configuration
by Matt Helm

Salsify's Powerful Channel Syndication Features - How to Deliver the Right Data to Downstream Channels
by Steve Engelbrecht

Sitation Earns Gold Akeneo Partnership, Expands PIM Delivery Capability
by Steve Engelbrecht

Steps to a Successful Akeneo Implementation: Part 1 - What are your goals for PIM?
by George Dzuricsko

A Deep Dive into Akeneo's Product Version History
by George Dzuricsko

An Akeneo Primer: Workflows 101 - How To Work the Workflows
by Brad Johnson

Help! My Products Are Suddenly Missing in Akeneo
by Matt Helm

Cheat Sheet: 9 Steps to a Successful Akeneo Implementation
by Sitation

Why You Should Adopt Akeneo's Built-in Tools Rather Than Forcing Functionality Into Akeneo
by Matt Helm

Akene-Oh No: Common Pitfalls to Avoid When Using the Akeneo PIM
by Matt Helm

Why Better Taxonomy Is a Delight to Merchants and Consumers Alike
by Autumn Demonet

5 Fundamentals to Master Product Experience Management
by Catherine Marquand

Akeneo: Requiring an SSL Connection with MySQL
by Don Bales

Akeneo: The Missing MTA Documentation
by Don Bales

Keys to a Great Akeneo Discovery
by George Dzuricsko

Sitation Earns Silver Partner Badge with Akeneo PIM
by Steve Engelbrecht

Ecommerce Veteran Sitation Finds New Opportunities Despite Pandemic
by Elizabeth Moore (GrepBeat)

B2B E-Commerce: Where should I start?
by Steve Engelbrecht

Akeneo 4.0 Features We Are Most Excited About
by George Dzuricsko

Sitation Announces Partnership with Akeneo
by Sitation Team

Work From Home Productivity Tips
by Steve Engelbrecht

Ecommerce Trends for Digital Transformation in 2020
by Megan Fitzpatrick

A Distributor's Guide to Sourcing Product Content
by Craig Lewis

An Efficient Taxonomy Can Benefit Your SEO
by Megan Fitzpatrick