Listing Health

Test phase and availability

Listing Health is currently only enabled for a selected group of sellers and may therefore not yet be available in your system.

The feature is currently only available for the sales channel Amazon. All available Amazon country platforms are supported. Support for additional sales channels is planned.

Listing Health helps you identify and resolve problems with your Amazon listings. The feature groups detected problems, shows you the affected SKUs and suggests steps to resolve them. This helps you keep track of the status of your listings and identify which problems to tackle first.

1. How Listing Health works

Amazon sends notifications when errors occur with your listings. Listing Health regularly retrieves these notifications in the background and analyses them. Not every notification is displayed as a separate problem. If the same error occurs for multiple SKUs, Listing Health displays a single problem covering all affected SKUs.

You can view the detected problems in a central overview, filter them by marketplace and severity, and view the affected SKUs. For most problems, Listing Health suggests steps to resolve them in the detail view. For more information, refer to the chapter Resolving problems.

Important: Listing Health does not make any changes to your items or listings. You must carry out the suggested steps yourself in PlentyONE or in the marketplace backend. The feature also does not automatically detect whether a problem has been resolved on Amazon. Therefore, first complete all suggested steps. Then check on Amazon yourself whether the listing is available again as expected.

2. Overview

To open Listing Health, go to Sales channels » Listing Health or click shield Listing Health in the right-hand sidebar.

At the top left, you can see when Listing Health last checked for problems (Last checked). Click refresh Refresh at the top right to start a new check manually, for example after exporting items to Amazon again.

Below, you will find key figures showing the status of your listings and a table of the detected problems.

2.1. Key figures

At the top of the overview, you will find two key figures showing the status of your listings.

2.1.1. Open problems

The Open problems key figure shows the number of problems with the status Open or In progress and the number of SKUs affected by these problems. Problems with the status Awaiting manual check are not included.

You can also see:

  • the change compared with the previous week and the number of open problems in the previous week

  • the number of problems awaiting a manual check under Not counted

  • a chart showing the development of open problems over the last calendar weeks

2.1.2. Listing coverage

The Listing coverage key figure shows the number of listings for each Amazon country platform in the following states:

  • Healthy (green): There are no problems with the listing.

  • Issues (orange): The listing has at least one problem with the severity Visibility or Degraded.

  • Blocked (red): The listing has at least one problem with the severity Blocking.

2.2. Viewing and filtering problems

The table lists all detected problems. Use the tabs to view problems according to their processing status:

  • Open: Shows new and currently processed problems with the status Open or In progress.

  • Awaiting manual check: Shows problems for which all suggested steps have been completed or ignored and which still need to be checked.

  • Closed: Shows problems with the status Solved or Ignored.

You can narrow down the displayed problems using the following filters:

  • Marketplace: Filters problems by Amazon country platform.

  • Severity: Filters problems by their impact.

Use the search field to search by problem name, problem ID (e.g. P-15) or SKU. The search also includes problems in the Awaiting manual check and Closed tabs.

The table provides the following information:

Column Explanation

Problem

Name and description of the detected problem. Below, you can see the number of affected products and the problem ID. Recurring problems are also marked with the Recurring flag. For more information, refer to the chapter Recurring problems.

Severity

Shows how severely the problem affects the listing.
Possible severity levels:

  • Blocking: The product cannot be purchased, or Amazon has suppressed or removed the listing. This problem has an immediate impact on sales and should be resolved first.

  • Visibility: The product can still be purchased via a direct link but cannot be found through Amazon search.

  • Degraded: The product can still be purchased, but some product information is hidden, or Amazon reports an error that does not currently require action. If the problem persists, it may become more severe.

Status

Shows the current processing status of the problem. For more information, refer to the section Problem status.

Affected SKUs

Number of SKUs affected by the problem.

Marketplace

Amazon country platform where the problem was detected.

Open

Shows how long the problem has existed.

3. Problem details

Click chevron_right View breakdown at the right-hand end of a problem’s row to open the detail view. Use the arrows at the top right to navigate to the previous (chevron_left) or next (chevron_right) problem. Click Back to Listing health at the top left to return to the overview of all detected problems.

Below the problem title, the Problem ID is displayed. To the right of the title, you can see the severity and status. Via More actions (more_vert) you can ignore the entire problem or reopen an ignored or solved problem.

Below, you will find further information about the selected problem:

  • Amazon error: Severity, error code and original error message from Amazon. The error message is displayed as sent by Amazon. This row is only displayed if Amazon has sent an error code.

  • Marketplace: Amazon country platform where the problem was detected.

  • Detected: Date and time when the problem was first detected.

  • Last update: Date and time when Amazon last reported the error.

  • Affected SKUs: Number of SKUs affected by the problem.

  • Status: Current processing status of the problem.

3.1. Viewing affected SKUs

In the detail view, activate the Show affected SKUs toggle (toggle_on) to display a table listing the SKUs affected by the problem. The table contains the following information:

Column Explanation

SKU

SKU of the affected variation.

Variation

Variation ID of the affected variation.

ASIN

Amazon Standard Identification Number of the product.

Amazon error

Error code reported by Amazon for the respective SKU.

Status

Status of the SKU provided by Amazon, if available.

3.2. Steps for you

In the Steps for you section, Listing Health suggests steps to resolve the problem. Each step is displayed as a separate card. For details on how to process the steps, refer to the chapter Resolving problems.

A safe suggestion is not available for every problem. For details on what to do in this case, refer to the chapter No safe recommendation available.

4. Resolving problems

Listing Health helps you resolve problems with your listings and track the progress. The suggested steps serve as guidance. You carry out the actions yourself in PlentyONE or in the marketplace backend and then record your progress in Listing Health.

4.1. Carrying out or ignoring suggested steps

The suggested steps for resolving the problem are displayed as individual cards in the Steps for you section. Each card contains a number, a title, a description of the suggested action and the Mark as done checkbox.

Note: The suggestions serve as guidance for resolving the problem. Listing Health does not make any changes to your items or listings. You must carry out the suggested steps yourself in PlentyONE or in the marketplace backend.

Carrying out or ignoring suggested steps:

  1. Go to Sales channels » Listing Health.

  2. Click chevron_right View breakdown at the right-hand end of a problem’s row.
    → The problem detail view opens.

  3. Read the problem description.

  4. Activate the Show affected SKUs toggle and check which SKUs are affected.

  5. Read the suggested action on the first card in the Steps for you section.

  6. Decide how you want to handle the suggested action:

    1. If you want to carry out the action:

      1. Carry out the action in PlentyONE or in the marketplace backend.

      2. Then activate the Mark as done checkbox (select_check_box).
        → The card for this step is collapsed.

    2. If you do not want to carry out the action:

      1. Click close Ignore step instead.
        → The card for this step is collapsed and marked as Ignored.

  7. Repeat this process for all remaining steps.

Note:

  • Ignored steps also count as completed for the progress status. However, ignoring an individual step does not mean that the entire problem is ignored.

  • Click Undo to reopen a completed or ignored step.

You can see the progress, e.g. 0 of 1 steps done, at the top right and bottom left of the Steps for you section. Once all steps have been completed or ignored, the problem status changes to Awaiting manual check. Then check on Amazon whether the listing is available again as expected.

Transferring changes to Amazon

Many steps involve changing item data in PlentyONE, such as attributes or categories. These changes only take effect once the affected items have been exported to Amazon again. It may take several hours for Amazon to process the changes, and in some cases up to 24 hours. Therefore, do not check the listing immediately after the export.

4.2. Problem status

The status shows you how far the processing of a problem has progressed.

Status Meaning

Open

The problem has been detected. You have not yet marked any of the suggested steps as done or ignored.

In progress

You have marked at least one, but not all, of the suggested steps as done or ignored.

Awaiting manual check

You have marked all suggested steps as done or ignored them. Now check whether the listing is available on Amazon again. If the listing is available again as expected, click Mark as solved.

Solved

You have checked the listing on Amazon and manually marked the problem as solved using Mark as solved.

Ignored

You have ignored the entire problem using More actions (more_vert) and the Ignore problem function. It is no longer counted among the open problems but remains visible in the Closed tab.

4.3. Marking a problem as solved

Once you have carried out or ignored all suggested steps, the problem status changes to Awaiting manual check. Now check on Amazon whether the listing is available again as expected. If the problem has been resolved, mark it as solved.

Important: Listing Health does not automatically detect whether a problem has been resolved on Amazon. Therefore, check the listing on Amazon yourself before marking the problem as solved.

Marking a problem as solved:

  1. Go to Sales channels » Listing Health.

  2. Click chevron_right View breakdown at the right-hand end of a problem’s row.
    → The problem detail view opens.

  3. Click Mark as solved at the bottom right of the Steps for you section.
    → The problem receives the status Solved and is displayed in the Closed tab.

Note: The Mark as solved button is only active once all steps have been completed or ignored.

4.4. Ignoring or reopening an entire problem

You can ignore an entire problem if you do not want to work on it. It then receives the status Ignored and is no longer counted among the open problems. You can still find it in the Closed tab.

Ignoring an entire problem:

  1. Go to Sales channels » Listing Health.

  2. Click chevron_right View breakdown at the right-hand end of a problem’s row.
    → The problem detail view opens.

  3. Click More actions (more_vert) at the top right.

  4. Click Ignore problem.
    → The problem receives the status Ignored.

If you want to work on an ignored or solved problem again, you can reopen it.

Reopening an ignored or solved problem:

  1. Go to Sales channels » Listing Health.

  2. Switch to the Closed tab.

  3. Click chevron_right View breakdown at the right-hand end of a problem’s row.
    → The problem detail view opens.

  4. Click More actions (more_vert) at the top right.

  5. Click Reopen problem.
    → The problem is reopened. You can find it in the Open or Awaiting manual check tab.

4.5. No safe recommendation available

For some problems, no safe suggestion for a resolution is available yet. In this case, the message No safe recommendation yet is displayed in the Steps for you section.

You can leave the problem open or ignore it using More actions (more_vert) and the Ignore problem function. Once a suitable suggestion is available, you can work on the problem.

Listing Health takes into account when the same error is reported for additional SKUs or when it occurs again for a problem that has already been marked as solved.

5.1. Additional affected SKUs

If additional SKUs with the same error are detected, they are added to an existing problem with the status Open. If the problem already has the status In progress, no further SKUs are added. This ensures that the list of affected SKUs does not change while you are working on the problem.

5.2. Recurring problems

If the error from a problem that has already been marked as solved occurs again, Listing Health creates a new problem. This problem is marked with the Recurring flag.

The detail view of the new problem displays a message stating that the same error occurred in an earlier problem that was marked as solved. The message includes the problem ID of the earlier problem. Click this problem ID to open the earlier problem and see which steps resolved it at the time.