What does the full error say?
The string recorded in the Acumatica community is “Product options could not be created in Shopify. There are 1 variant types in the MISIML template item, but Shopify supports only up to 3 product options.” The item code will be yours; the shape of the sentence will not change.
Read the count in the middle of it. That number is how many variant attributes the connector found on your template item, and the message prints it whether the number is too high or too low. A “1” there means the opposite problem from the one the sentence appears to describe.
Checked against: Acumatica community 18873: template item sync error, read 20 August 2026, Shopify Admin GraphQL Product object, option limits
What actually causes it?
Three separate situations produce this one message, and the thread records all three.
More than three variant attributes on the template item. Shopify products carry at most three options, so a A matrix item is Acumatica’s way of describing a product that comes in variations, such as a shirt in four sizes and three colours. Acumatica calls the parent a template item and generates a stock item for each combination. built on colour, size, length and material has nowhere to land. This is the case the message is actually written for.
Exactly one variant attribute. The accepted answer in the thread is blunt about the workaround: add a second attribute, and “your dummy variable can be something trivial like color and it can be the same for every variant, but it has to be there”.
Shopify variants that have no matching matrix item in Acumatica. If somebody created variants directly in Shopify, or matrix items were deleted on the Acumatica side, the two sides disagree about what exists and the option build fails.
Checked against: Acumatica community 18873, accepted answer, read 20 August 2026
How do you clear it?
Match the fix to which of the three you have. Count the variant attributes on the template item first, because that single number tells you which branch you are on.
More than three attributes: split the template. One user in the thread split a fall-harness product into two templates, one carrying the back-brace option and one without, to stay inside the three-option ceiling. There is no configuration that avoids this; the ceiling is Shopify’s.
Exactly one attribute: add a second variant attribute, even a trivial one with the same value on every variant. Ugly, documented, and it works.
Mismatched variants: clear the last sync, delete the matrix items, remove the problem attribute from the item class, recreate the matrix items, then resync. That is the sequence given in the thread, and the order matters.
After any of the three, resync the template item before you resync product availability, because availability depends on the template having landed first.
Checked against: Acumatica community 18873, read 20 August 2026
Which release is this, and what if the fix does not hold?
The thread does not name an Acumatica release, which is worth saying plainly rather than guessing. Shopify’s three-option ceiling has been stable for years and is documented on the Product object, so the ceiling itself is not going to move under you. The connector’s behaviour around it can, and has: on 2025 R1 a related duplicate-value validation appeared that was not present on 23R2.
If you split a template and the error returns on the new templates, look for orphaned Shopify variants left behind by the split. The split creates new products; the old product keeps its variants unless you remove them, and the connector will keep trying to reconcile both.
If your product genuinely needs four or more variant axes and splitting the template is not commercially acceptable, this is a platform ceiling rather than a connector defect, and it is one of the few situations where changing storefront is the honest answer instead of changing integration.
Checked against: Shopify Admin GraphQL Product object, Acumatica community 30860: the 25R1 duplicate option value validation
Common questions
- Why does this error mention 3 product options when my item has only one attribute?
- Because the message prints the count it found and then quotes Shopify’s ceiling regardless of which direction the mismatch runs. A count of 1 means the template item has too few variant attributes, not too many. The documented workaround is to add a second attribute, even one with the same value on every variant.
- Can Shopify be configured to allow more than three product options?
- No. Three options per product is a limit of Shopify’s product model, documented on the Admin API Product object, and no Acumatica setting changes it. If your item needs four or more variant axes, you either split it into multiple templates or you accept that this storefront cannot hold that product shape.
Last updated 2026-08-20. Facts on this page last checked against source 2026-08-20.