Skip to main content
Amazon

Load family in the Amazon connector for Odoo: myths and reality

Load family prepares a product's variant family in Odoo: it creates listings for variants that have a reference but are not yet part of the family, writes the variation theme, the parent SKU and other data to all of them, and leaves a report in Variation family. It only appears when the product has at least two variants and the listing has an Amazon Product Type.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 5 November 2026

Key facts

Module
Amazon
Versions
Odoo 17, 18, 19 and 20
Checked
in the connector's source code, version 20.0 · against the sources linked at the end
Reading time
5 min

Where the button is and when you see it

The Load family button is on the Listings form, which opens from Amazon › Catalog › Listings. Each menu level asks for the Viewer permission. The button exists in Odoo 17, 18, 19 and 20.

It is hidden when Product Variant Count is below two or when Amazon Product Type is empty. With the default values you will not see it, because the product type is empty.

Code-built diagram: the Amazon, Catalog, Listings menu, the Load family button and, to one side, the messages that can stop it
Diagram (not an Odoo screen) showing the menu, the button and the messages that can stop it, with the English labels from the module's code.
Your Odoo doesn't talk to Amazon, Temu or Shopify?
Video: Your Odoo doesn't talk to Amazon, Temu or Shopify?

What it does when you press it

These are the main steps visible in the code, in order:

  1. It checks your permissions: you need operator access to the connector (or manager access) and, as well, the ability to write to the listing.
  2. If the product has fewer than two variants, it stops with a message and does not get as far as creating listings or writing data to the family.
  3. It creates listings for variants that have a reference and are not yet part of the family, using the same account, the same marketplace and the reference as the SKU.
  4. It settles the variation theme: if the listing already has one, it keeps it; if not, the connector may propose one or leave it empty.
  5. It writes to every listing in the family the theme, parent SKU, product type, requirements mode and GTIN exemption of the listing you pressed the button on.
  6. If there is a theme, it copies some values you typed on this listing to the others (see below for which).
  7. It writes the report in Variation family and shows the notice Family of … listings ready: see "Variation family"., with the number of listings in the family. The form reloads to show the new values.

Common misconceptions about Load family

"The button is on every listing"

Reality: you only see it with two or more variants and with Amazon Product Type filled in. If you open a freshly created listing and cannot see it, that is what the default values give.

Code-built diagram: the Load family text as it appears in each Odoo language (Spanish, German, French, Italian and Portuguese)
Diagram (not an Odoo screen) showing the button label translated into Spanish, German, French, Italian and Portuguese, as published in the module's translation files.

"If I can see the menu, I can press the button"

Reality: the menu asks for Viewer at every level, but the action checks more. If your user does not have at least operator access, it stops with You need at least Amazon Seller Connector Operator access for this action. Ask a manager to grant Operator or Manager access. The fix is to ask a manager to give you Operator or Manager access. Apart from the groups, the code checks that you can write to the listing.

"Loading the family means creating it on Amazon"

Reality: the button prepares the family in Odoo (new listings, data written to the listings in the family and a report); creating it on Amazon is a different button's job.

"It creates a listing for every variant"

Reality: it creates listings only for variants that have a reference and are not yet part of the family. Variants that are already part of the family are not created again. Variants without a reference that were not in the family are left out, and the report lists them after Variants without a reference (SKU), left out of the family:. If the product has fewer than two variants, the action stops with This product has no variants: it goes to Amazon on its own.

"What I type in one listing is copied to all the others"

Reality: not everything is treated the same way. The theme, parent SKU, product type, requirements mode and GTIN exemption are written to every listing in the family. Attribute values, on the other hand, are copied under conditions: only if there is a theme, only those typed on the listing you pressed the button on, only for attributes the chosen theme does not need, and only into the matching lines on the other listings that are empty.

"If the report flags rows, it has failed"

Reality: if the action gets to the end, the notice is the same either way; the detail is in the report. When something does not fit, it does not show up as a failure of the action but as a flagged row in the report's table.

What to look at in the Variation family report

At the top you will see Theme:, it needs: and Parent SKU:. Below is a table with Odoo attribute and Amazon attribute. Each row says OK or, highlighted, Does not fit the theme: set "Amazon attribute" on the Odoo attribute, or type the value in each variant.

Next comes the Variants: list, with the SKU of each listing and, in brackets, its ASIN if it comes from Amazon or new if not. If there is no theme, the report shows none fits: choose one and a list of Themes this product type allows (some):.

If you want help getting set up

The module is a one-off payment per version and needs the FlexigoTech Cloud subscription (Connector plan: €49 a month or €490 a year, excluding VAT); the connection goes through that service. FlexigoTech implements Odoo 17, 18, 19 and 20 and builds custom connectors and integrations. See the module page for more.

Keep reading

Checked in the connector's source code (version 20.0) and the linked sources

Sources