Enhanced Support for Complex Products
The productVariantsBulkCreate and productVariantsBulkUpdate mutations now feature dynamic complexity costing to better reflect the true computational cost of operations. This upgrade allows merchants on all plans to create products with up to 2,048 variants, significantly increasing the previous limit of 100 variants. This improvement supports the needs of businesses with diverse and complex product offerings.
Breakdown of Dynamic Complexity Costing
With the introduction of Dynamic Complexity, these mutations now compute cost as follows:
- Base Cost: 10 points
- Per Variant: 0.2 points
- Per Variant Media: 0.6 points
- Per Variant Metafield: 0.4 points
- Per Product Media: 1.9 points
The total complexity for any operation is calculated using the formula:
Total Cost = 10 + (variants × 0.2) + (variant_media × 0.6) + (variant_metafields × 0.4) + (product_media × 1.9)
Guidance for Migration
For most apps, no changes are required. However, developers working with high-complexity products above the 1,000-point single query limit should consider the following:
- Use bulk mutations for large operations where possible to optimize efficiency.
- For highly complex operations, split the workload into smaller subsets. Utilize the productVariantsBulkCreate and productVariantsBulkUpdate mutations for core variant data, followed by metafieldsSet and fileCreate for supplemental data like metafields or file attachments.