Shop the Look

Shop the Look finds the model photos of your shop, lets an AI describe the garments worn and suggests the matching products from your catalog. You review every suggestion yourself. Accepted looks are written to the shop as normal cross-selling lists, with a preview first and an undo afterwards.

The work always runs in the same order: import images, AI description, calculate suggestions, review, write to shop.

Where to find it

Open Products > Shop the Look.

The overview shows the coverage of your shop (Coverage: ... of ... products have a look) and a row of tiles. Each tile is a quick filter: click it to see the entries, click it again to clear the filter.

With Season and Show you limit the overview to one season. All seasons shows everything again. Seasons only appear when the season field is set in the settings.

In an image list, a click on a photo with the status to review opens the review. A click on any other photo shows it large with Product, Status and File. In a product list, a click opens the images of the product or the product in the quality check, depending on your permissions.

What you need

• The permission View looks to open the area.
• The permission Import images, start AI description, calculate suggestions for importing, the AI run, the suggestions and for saving the settings. It writes nothing to the shop.
• The permission Decide on looks and write them to the shop for the review and for writing to the shop.
• A connected shop, see Onboarding.
• For the AI description: an AI key and the AI feature Shop the Look: image description turned on. This feature is off by default. A person with the permission Manage AI turns it on under AI settings, see AI. Without AI you can still import images and write Matching products.
• For writing: a shop that is not Read-only.

Note: If an approval rule applies to your role, writing to the shop is only submitted. Nothing changes in the shop until a team lead approves, see Approvals.

How do I import the images?

1. Open Products > Shop the Look.
2. Click Import images. A job starts and the button shows the progress.
3. Wait until the page reloads. The tiles now show the new numbers.

What happens during the import:

• plinth reads the main products and their images from the shop. Nothing is written to the shop.
• Every image is checked once. Images without a white background count as model photos.
• Only new or changed images are checked on later runs, the newest first.
• Images older than the age limit in the settings are not checked. Model photos with an image format that is not allowed are listed under Ignored (format).
• An image that could not be loaded because of a temporary error is tried again on the next import.

Note: Import the images again after new products or new photos were added in the shop. Products and images that no longer exist in the shop disappear from the lists.

How do I start the AI description?

1. Click More actions > AI description.
2. The dialog AI description of model photos shows how many images will be sent, how many are already described and the estimated cost in EUR.
3. Click Confirm cost and start. Without this confirmation nothing is sent.
4. Wait until the dialog shows Done. The page reloads by itself.

What you should know:

• Only the image is sent to the AI. No product data and no customer data are sent.
• The AI describes each garment worn: kind, color, pattern and for whom it is meant.
• Images that are already described cost nothing. The same image is never sent twice.
• A run sends no more images than the estimate showed. If the dialog says The per-run limit was reached., start the AI description again after the run to describe the remaining images.
• After the run, plinth calculates the suggestions automatically.
• The AI description writes nothing to the shop.

How do I calculate the suggestions?

The suggestions are calculated by fixed rules, not by the AI. This costs nothing.

1. Optional: choose a Season and click Show to limit the calculation to this season.
2. Click More actions > Calculate suggestions.
3. A message shows Suggestions calculated: with the number. The page reloads.

Use this after you changed the settings or imported new products. Open suggestions are calculated again. Looks you already decided on are never changed.

How does plinth find the matching products?

For each garment in the description, plinth looks for products in your catalog:

• The product must have the same brand as the product of the photo and must be the same kind of garment.
• Season, gender and color must not contradict. By default only products of the same season are suggested.
• Each product gets a match score. Products below the minimum match score are not suggested.
• At most two products are suggested per garment.
• The product the photo belongs to is part of the look anyway and is not suggested again.

Described photos without any suggestion are listed under No match.

How do I review the looks?

1. Click Review looks on the overview. The number on the button shows how many suggestions are waiting.
2. You see one model photo at a time with the heading On the photo of and the product name. The Confidence value shows how sure the match is. The suggestions with the highest confidence come first.
3. Next to the photo are the suggested products. Each one shows its Match score, the garment it stands for (worn:) and the reasons for the match, for example brand, season or color.
4. All suggested products are selected. Deselect the ones that are not on the photo. The keys 1 to 9 toggle single products.
5. Decide:
   • Fits (key Y) accepts the look with the selected products.
   • Doesn't fit (key N) rejects the whole suggestion.
   • Later (key S) leaves the suggestion open. It appears again the next time you open the review.
6. When everything is decided you see Nothing left to review. Click Back to overview.

A decision writes nothing to the shop. Accepted looks are counted under Accepted, not in shop until you write them.

How do I take back a decision?

Click the arrow button in the review bar (Take back the last decision) or press U. The suggestion is shown again. This only works for decisions you made since you opened the review; after you leave the page, an accepted or rejected suggestion cannot be reopened here. Looks that are already in the shop cannot be taken back here, see "How do I undo or remove looks in the shop?".

How do I write the looks to the shop?

1. Click Write looks on the overview. In the review you can use Write accepted looks to shop instead. If the button is not shown, use More actions > Write looks.
2. The dialog Write looks to shop first calculates a preview. Nothing is written yet.
3. Check the preview. Lists to change: shows the number of lists. The table shows per Product · list the products Before and After.
4. Click Write to shop.
5. Wait for Done. Reload the page to see the updated tiles.

If the preview says Nothing to change., the shop already has these lists.

What exactly is written?

• Every product of an accepted look gets a cross-selling list in the shop. The list is named "Shop the Look" unless another name is set in the settings.
• The list of a product contains the other products of its looks: the product of the photo and the products you selected. A product in several looks gets all of them in one list.
• If a product has no such list yet, plinth creates it. If a list with this name exists, plinth changes its products so that it matches the accepted looks.
• Other cross-selling lists of the product are not touched.
• These are normal cross-selling lists of the shop. They stay in the shop and keep working without plinth.
• After writing, the looks have the status in shop.

How do I undo or remove looks in the shop?

Right after writing, the dialog shows the button Undo. Click it and wait for Undone.

Later you undo the job on the Jobs page. The job is named Shop the Look: write looks to shop.

What the undo does:

• Lists that existed before get back their earlier products in the earlier order.
• Lists that the job created are removed from the shop.
• The looks of this job go back to Accepted, not in shop. You can write them again later.

Warning: There is no separate delete button for a look that is in the shop. The only way to remove it is to undo the job that wrote it.

How do I add matching products for products without a look?

For products that are in no look, plinth can write a rule-based list of matching products. No AI is used.

1. Optional: choose a Season and click Show to limit this to one season.
2. Click More actions > Matching products.
3. The dialog Matching products (rule-based fallback) shows the preview with Before and After.
4. Click Write to shop and wait for Done.

The rule: same brand, same season and fitting gender, a different kind of garment, fitting colors first. At most two products per kind of garment and six products per list. The list is written as a separate cross-selling list named "Passende Artikel" unless another name is set in the settings. Products that are part of a look are skipped.

You undo this the same way as looks: with Undo in the dialog or on the Jobs page, job Shop the Look: write matching products.

How do I change the settings?

1. Click More actions > Settings.
2. The page Shop the Look settings shows the settings of this shop as text in JSON form: names in quotes, entries separated by commas.
3. Change the values and click Save. The page shows Saved.
4. Click Back to overview.

Saving needs the permission Import images, start AI description, calculate suggestions. Without it you can only read the settings.

After a change, run Import images (for season, gender, color and age limit) and then Calculate suggestions.

Warning: Do not change crossName or fallbackName after lists were written. Lists with the old name stay in the shop and plinth no longer updates them.

Which jobs does Shop the Look start?

Longer steps run as jobs. You find them with progress, result and errors on the Jobs page.

The preview in both dialogs also runs as a job. It changes nothing.

Common errors and fixes

See also

• Images
• AI
• Jobs
• Approvals
• Products
• Quality
• Onboarding