Product Readiness FAQ and troubleshooting

Find answers to common questions about Product Readiness scores, configurations, permissions, and recalculation.

General questions

What is Product Readiness?

Product Readiness determines whether a product meets a configurable set of business requirements for a particular publishing goal, channel, and locale.

How is Product Readiness different from Completeness?

Completeness checks whether the required attributes defined by a product's family contain values.

Product Readiness checks whether a product satisfies the custom requirements defined in a Readiness Configuration. These requirements can evaluate attribute values, categories, groups, associations, dates, prices, and other product information.

Can a product have several readiness scores?

Yes. Several Readiness Configurations can apply to the same product.

Each applicable configuration produces its own results for the relevant channel and locale combinations.

Can readiness differ by channel and locale?

Yes. Readiness is evaluated separately for each applicable channel and locale.

A product may therefore be ready for one market or publishing channel while still requiring work for another.

Questions about scores

How is the readiness score calculated?

The readiness score is the percentage of applicable requirements that the product meets:

Score = 100 × met requirements ÷ applicable requirements

The result is rounded to the nearest whole number.

What does a score of 100% mean?

A score of 100% means the product meets every applicable requirement for the selected Readiness Configuration, channel, and locale.

What does a score of 0% mean?

A score of 0% means that requirements apply to the product, but none of them are currently satisfied.

Why is the score N/A?

A score of N/A means none of the configuration's requirements apply to the product.

This can happen when:

• A required attribute is not part of the product's family.
• Every requirement is limited to a different channel or locale.
• The product does not contain the type of data targeted by the requirements.

Non-applicable requirements are skipped and removed from the score calculation.

Why has the readiness score not updated?

Readiness scores are recalculated automatically after relevant product information or configurations change.

Updates may take longer when:

• A configuration applies to a large number of products.
• Several configurations were changed at the same time.
• A large import or mass-edit operation is being processed.
• The PIM is processing other background jobs.

Why did a product's score decrease?

A readiness score may decrease when:

• Product information is removed or changed.
• A category, group, or association changes.
• A new requirement is added to the configuration.
• An existing requirement becomes more restrictive.
• The configuration's channel, locale, or product selection changes.

Do all requirements have the same weight?

Yes. Every applicable requirement contributes equally to the final score.

Requirement groups also count as one requirement, regardless of how many sub-requirements they contain.

Questions about configurations

How many requirements can a configuration contain?

A Readiness Configuration can contain up to 25 requirements.

Can Readiness Configurations overlap?

Yes. The same product can be included in several configurations.

This is useful when a product must meet different requirements for separate retailers, countries, channels, campaigns, or business processes.

What happens when a configuration is changed?

Akeneo recalculates the readiness scores of the affected products in the background.

Depending on the change, many products may be evaluated again. This can also cause products or product models to cross the 100% readiness threshold and generate Event Platform events.

What happens when a configuration is deleted?

The readiness results associated with that configuration are removed.

Deleting a configuration does not delete or modify the affected products, product models, attributes, categories, or other product information.

Can I reuse an existing configuration?

Duplicate an existing configuration when you need a similar product selection or set of requirements for another publishing goal.

Review the duplicated configuration's code, label, product selection, channels, locales, fallbacks, and requirements before using it.

Questions about requirements

What is a requirement group?

A requirement group combines several sub-requirements and treats them as one requirement in the readiness score.

• An AND group passes only when every sub-requirement passes.
• An OR group passes when at least one sub-requirement passes.

What is a non-applicable requirement?

A requirement is considered non-applicable when it cannot be evaluated for the selected product.

For example, an attribute requirement is non-applicable when the attribute is not included in the product's family.

Non-applicable requirements are skipped and do not lower the product's score.

How do locale fallbacks affect readiness?

A locale fallback allows a requirement to use a value from another locale when the value for the evaluated locale is unavailable.

When a valid fallback value satisfies the requirement, the requirement can pass even though the primary locale does not contain its own value.

Permissions and access

Why can't I see Product Readiness?

Your role may not include permission to view Product Readiness results or configurations.

Ask an administrator to review your role from System → Roles.

Why can't I create or edit a Readiness Configuration?

Creating and managing configurations requires dedicated Readiness permissions.

Having access to view readiness scores does not necessarily allow you to create, edit, delete, import, or export configurations.

Do normal product permissions still apply?

Yes. Product Readiness does not override existing product, category, locale, channel, attribute group, or user-group permissions.

Users can only view and edit the product information already available to them through their assigned permissions.

Import and export questions

Why did my configuration import fail?

An import may fail when the destination PIM does not contain an entity referenced by the configuration.

Check that the destination environment contains the required:

• Channels and locales
• Attributes and attribute options
• Families
• Categories and groups
• Reference entities and records
• Currencies and other required configuration data

Does exporting a configuration include product readiness scores?

Exporting a Readiness Configuration exports the configuration itself, including its selection, contexts, and requirements.

Product results are separate. Use a product export or the REST API when you need to retrieve products according to their readiness state.

API and Event Platform questions

Can I retrieve readiness scores through the API?

Yes. Use the with_readiness query parameter on supported product and product model endpoints.

• Use scores_only to retrieve readiness scores.
• Use detailed to retrieve scores and unmet requirements.

When are readiness events published?

An event is published when a product or product model crosses the readiness threshold:

• From below 100% to 100%
• From 100% to below 100%

Events are not published after every recalculation when the product remains on the same side of the threshold.

Why didn't I receive a readiness event?

Check whether:

• The product actually crossed the 100% threshold.
• The relevant configuration applies to the product.
• The expected channel and locale combination was affected.
• Your Event Platform subscription includes the correct event type.
• The readiness recalculation has completed.

Troubleshooting checklist

When a readiness result is unexpected:

1. Confirm that the correct Readiness Configuration applies to the product.
2. Check the selected channel and locale.
3. Open the unmet requirements list.
4. Check whether any requirements are non-applicable.
5. Review requirement groups and their AND or OR logic.
6. Check any configured locale fallbacks.
7. Confirm that recent background recalculations have completed.
8. Ask an administrator to review your permissions if information or actions are missing.