Error and Warning Codes
This page documents error and warning codes you may encounter when using Ablestar Bulk Product Editor. Each code includes a short description and suggested next steps.
Metafield Errors (MTF)
MTF001 - Value Not In Allowed Choices
The metafield that you are trying to edit only lets you select from a limited set of values. The validations are configued in the Shopify admin.
How to fix
You can either change the value to one of the allowed choices, or update the validation in the Shopify admin.
MTF002 - Value Length Constraint
The metafield value is either too short or too long.
How to fix
Adjust the text you are trying to set or update the metafield definition's validations in the Shopify admin.
MTF003 - Duplicate Values Not Allowed
Metafields that are a list of values cannot contain duplicate values.
How to fix
Filter your products to exclude products with the duplicate value before editing.
MTF004 - Blank Values Not Allowed
The metafield value is blank when a value is required. This may occur if you are trying to set a list metafield and one of the elements in that list is blank.
How to fix
Provide a non-blank value. Check for formatting issues (e.g., trailing commas in lists).
MTF005 - Definition Constraint Mismatch
The metafield definition is configured to only show on products in certain categories and the product you are trying to edit is not in one of those categories.
How to fix
Either Change the product's category first to match the definition's constraints or relax the constraints in Shopify admin.
MTF006 - Metaobject Not Found
The metaobject referenced by handle or title could not be found in the store.
How to fix
Verify the metaobject handle or title is correct, or refresh metaobjects data in Settings → Shopify Data and retry.
MTF007 - Metafield Definition Not Found
The metafield definition could not be found for the specified field.
How to fix
Verify the metafield definition exists and is accessible, or refresh metafield definitions in Settings → Shopify Data and retry.
MTF000 - Generic Metafield Error
A metafield-related error occurred when communicating with the Shopify API. Review the error message details for more information and reach out to support if you need help.
Product Errors (PRD)
PRD001 - Product Handle Already In Use
The product's new handle is already used by another product in the store. If doing an in-app edit, check the 'Make sure handle is unique' checkbox which will automatically add a number to the end of the handle if it is not unique.
PRD002 - Product Does Not Have An Option
Attempted to edit option 2 or 3, but the product does not have that option. For example, if the product has only one option, Size, you cannot edit the option 2 value or name.
How to fix
For an in-app edit, add a filter to for the option 2 or option 3 name to be sure that you are editing products with those options.
PRD003 - Invalid Product Status
The product status value is invalid. Status must be one of the allowed values: draft, active, or archived.
How to fix
Use one of the valid status values: draft, active, or archived.
PRD004 - Invalid Image URL
When you add an image to a product the app sends the image's URL to Shopify and then Shopify tries to download the image. This error message means that Shopify was unable to download an image from the provided URL.
There are a few reasons that Shopify could be unable to download an image:
- There is a typo in the URL or it is not valid. URLs should start with
http://orhttps:// - The URL is invalid or points to a page that is not an image file.
- The URL requires you to be logged in a site to view it. When Shopify requests the URL it is not logged in so will not be able to see the file
- The site hosting the images has code in place to prevent automatic access to image URLs. This is usually done to block bots or scrapers but will also interfere with the automated requests from Shopify
How to fix
There are several things you can do to check the image URLs:
- Make sure that the image URL works on your computer in a private browsing window
- Make sure that the URL points directly to the image, and not to an HTML page containing the image
If you are able to view the images correctly but they still are not uploading, it's likely that the remote webserver is blocking automated requests for the images. Please contact us and we will see what we can do.
PRD000 - Generic Product Error
A product-related error occurred with the Shopify API. Review the error message details for more information and reach out to support if you need help.
Variant Errors (VAR)
VAR001 - Duplicate Variant Options
You're trying to create a variant that already exists. Each variant on a product must have a unique combination of options (like size, color, material, etc.).
For example, if you have a t-shirt with these existing variants:
- Small, Red
- Medium, Red
- Large, Blue
You cannot create another "Medium, Red" variant because that combination already exists.
How to fix
Choose different option values that don't match any existing variant, or edit the existing variant instead of creating a new one.
VAR000 - Generic Variant Error
A variant-related error occurred with the Shopify API. Review the error message details for more information and reach out to support if you need help.
Edit and Validation Errors (EDIT)
EDT001 - Not A Whole Number (Integer)
Provided value is not numeric where a number is required. Do not include any commas or spaces in the number.
How to fix
Provide a valid whole number (e.g., 12, 12.0).
EDT003 - Unable To Convert Measurement
Unable to convert the provided value into a valid measurement for the field.
How to fix
Provide a value in the format {"value": 1.4, "unit": "KILOGRAMS"}.
EDT004 - Invalid Reference
Invalid reference handle or ID.
How to fix
Use a valid Shopify handle or GID/ID.
EDT006 - Invalid Number Formatting
The input number contains invalid spacing.
How to fix
Remove spaces or invalid separators in the number.
How to fix
Use one of the allowed values.
EDT011 - Blank Or Zero Value For Price/Cost
Compare-at price or cost is zero or blank where a non-zero value is required.
How to fix
Ensure the field has a valid non-zero value before applying percentage changes.
EDT012 - Not A Number (Parameter)
An edit parameter expected a number but received a non-numeric value.
How to fix
Provide a numeric value for the parameter.
EDT013 - Price Must Be A Number
Price needs to be set to a valid number during the edit.
How to fix
Provide a numeric price and retry.
EDT014 - Invalid Link Metafield Format
Link metafields must be of the form {"url": "http://...", "text": "Label"}.
How to fix
Provide the exact JSON structure with url and text.
EDT015 - Price Is Null
Attempted a percentage-based price change but the base price is null.
How to fix
Set a base price first.
EDT016 - Price Needs To Be A Valid Number
Price validation failed because the value is not numeric.
How to fix
Provide a numeric price value.
EDT017 - Unable To Convert To Date/Time
The provided value could not be converted to a valid date/time.
How to fix
Provide a correctly formatted date/time or use a supported conversion.
EDT018 - Missing Date Value Or Outdated Metaobjects
Either a required date value was not found, or metaobject data is out of date.
How to fix
Provide the missing date value, or refresh metaobject data in Settings → Shopify Data.
EDT019 - Tags Must Be A String
Tag lists must be provided as a string.
How to fix
Provide a comma-separated string of tags.
EDT020 - Markets Catalog Data Out Of Date
Markets catalog data appears outdated.
How to fix
Refresh Markets Catalog data in Settings → Shopify Data.
EDT021 - No Price Configured For Catalog
No price is configured for the specified catalog.
How to fix
Configure a price in the catalog and retry.
EDT022 - Invalid Published Value
published value is invalid.
How to fix
Use true/false (or valid string equivalents) for the published value.
EDT023 - No Published Value Set
published was not set.
How to fix
Provide a published value and retry.
Markets Errors (MKT)
MKT001 - No Catalogs For Market
No active catalogs were found for the market.
How to fix
Create/activate a catalog for the market, then retry.
MKT002 - No Currency For Market
The market does not have a currency set.
How to fix
Set the market's currency in Shopify.
MKT003 - No Catalog For Market
No catalog is associated with the specified market.
How to fix
Assign a catalog to the market and retry.
MKT004 - Markets Data Out Of Date
Markets data appears outdated and the price list for the market could not be found.
How to fix
Refresh Markets data in Settings → Shopify Data and retry.
MKT005 - Unable To Parse Catalog Price Data
The catalog price and compare-at price data could not be parsed properly. This occurs when the price data is missing, empty, or in an incorrect format. If you are editing these in a spreadsheet file, the price and compare-at price need to be in the following format:
{ "price": 10.0, "compare_at_price": 15.0 }
How to fix
Ensure that catalog price data is provided in the correct format with both price and compare-at price values properly structured.
Shopify API / GraphQL Client Errors (SAPI/GQL)
GQL005 - GraphQL Client Not Initialized
The GraphQL client session was not initialized. The app will reinitialize the session automatically.
How to fix
Usually automatic; if persistent, re-authenticate and retry.
SAPI008 - Shopify API Error (Images/Media)
Shopify API error encountered while applying changes (often related to media). The app may retry with a safer strategy.
How to fix
Retry the operation. If it continues, try reducing batch size or contact support.
SAPI009 - Shopify API Error
Shopify API error encountered during modifications.
How to fix
Retry later; check logs for details or contact support.
SAPI010 - Shopify API Error
Shopify API error encountered during modifications.
How to fix
Retry later; check logs for details or contact support.
SAPI014 - Shopify API Error (Publications)
Shopify API error encountered while applying publications; the app may retry item-by-item.
How to fix
Retry; if persistent, reduce scope or contact support.
If you encounter an unresolved issue: include the error code, message, and the action you were performing when contacting support. This helps us diagnose quickly.