At various places throughout the app you may encounter a warning or error code. These codes are formatted like ABC001. This document provides more context on the error codes as well as tips to resolve them.
File Analysis Codes
These codes will appear when you upload a spreadsheet to be imported with the app.
ALYS001 - File Does Not Exist
There was an error opening the file you uploaded. Please try again and contact us if the problem persists.
ALYS002 - Zip File Must Contains a CSV File
You can upload a ZIP file with multiple CSV files to have them processed at once. However in this case the app did not detect any CSV files in the zip file you uploaded.
If you want to process multiple Excel sheets at the same time you can combine them into a single Excel workbook and upload that.
ALYS003 - Unsupported File Type or Invalid Content
We couldn't determine if your file was CSV, Excel, or a valid ZIP. Please upload either a CSV file, an Excel workbook with the .xlsx extension, or a ZIP file containing CSV files so our system can process it.
ALYS004 - No Valid Sheets Found
Our system tried to read your file but did not detect any sheets with the required structure. Ensure your file includes sheets that match one of our supported object types (for example, a valid Products or Orders sheet) and try again.
ALYS005 - Unmatched Columns
You spreadsheet contains columns that Altera does not recognize and these columns will be ignored when you import data through the app.
The most common cause of this is trying to import data that does not match the Atlera/Matrixify format. To fix this, make sure your spreadsheet matches the format in our documentation ( Product Fields for example).
ALYS006 - Shopify Export Format
It looks like you are trying to upload an export of your Shopify products to Altera. Please try uploading the file again in the [Altera/Matrixify format]https://help.getaltera.com/en/articles/11490229-product-fields) .
ALYS007 - Unsupported Duplicate Columns
Some columns can appear multiple times in a spreadsheet but others cannot. Make sure that you don't have any columns with duplicate names besides Tags
and Image Src
.
ALYS008 - Invalid ID
The ID column should either be empty, contain a number like 8106245782738
, or contain a GraphQL identifier like gid://shopify/Products/8106245782738
. If it doesn't it may cause problems with the import. If your ID is a number, make sure it is a whole number, like 8106245782738
, and not formatted as a decimal number like 8106245782738.0
.
ALYS009 - Truncated Metafields
Excel has a character limit of 32,767 characters per cell. When metafields with exactly this character count are detected, they will be ignored during import to prevent data corruption in Shopify. This typically happens when Excel has truncated longer text values. For large metafield values, consider using CSV files for importing the values.
ALYS010 - WooCommerce Export Format
It looks like you are trying to upload an export of your WooCommerce products to Altera. Please try uploading the file again in the Altera/Matrixify format instead.
ALYS011 - DELETE Command Warning
You are using the DELETE command in your import. Please note that deleting items is permanent and cannot be undone. The deletion will also process any hidden rows in your spreadsheet, so make sure to review your data carefully before proceeding.
ALYS012 - REPLACE Command Warning
You are using the REPLACE command in your import. When replacing items, the existing item will be completely deleted and recreated with the new data. This means all existing data not included in your import will be lost. The replacement will also process any hidden rows in your spreadsheet, so make sure to review your data carefully before proceeding.
ALYS013 - ZIP File Contains Subdirectories
ZIP files uploaded for import should not contain subdirectories. All CSV files should be placed at the root level of the ZIP file. Please restructure your ZIP file to place all CSV files in the root directory without any subdirectories.
ALYS014 - ZIP File Contains Non-CSV Files
The ZIP file you uploaded contains files that are not CSV files. ZIP files for import should only contain CSV files (plus any system files like .DS_Store
which are automatically ignored). Please remove any non-CSV files from your ZIP file and try again.
Smart and Manual Collection Codes
Error and warning codes that occur when dealing with smart and manual collections
CLTN001 - Existing Collection is a Smart Collection
The collection that already exists in Shopify is a smart collection, but the import it trying to treat it as a manual collection. Shopify does not allow you to convert a smart collection to a manual collection. You can replace the collection however by setting the 'Command' column to REPLACE
.
CLTN002 - Existing Collection is a Manual Collection
The collection that already exists in Shopify is a manual collection, but the import it trying to treat it as a smart collection. Shopify does not allow you to convert a manual collection to a smart collection. You can replace the collection however by setting the 'Command' column to REPLACE
.
CLTN003 - Collection Already Exists
The collection you are trying to create with the NEW command already exists in your Shopify store. If you want to update an existing collection, use the MERGE or REPLACE command instead.
CLTN004 - Unable to Find Collection to Delete
The collection you are trying to delete cannot be found in your Shopify store. This may be because it was already deleted or because the identifier (ID or handle) provided in your import is incorrect.
CLTN005 - Unable to Find Metafield Definition
When creating a smart collection rule based on a metafield, the system could not find the corresponding metafield definition. Make sure that the metafield definition exists in your Shopify store, and has the 'Smart collection' enabled, before creating a smart collection rule that references it.
Discount Codes
Error and warning codes that occur when dealing with discount imports and operations.
DISC001 - Discount Already Exists
The discount you are trying to create with the NEW command already exists in your Shopify store. If you want to update an existing discount, use the MERGE or REPLACE command instead.
DISC002 - Unable to Find Discount to Delete
The discount you are trying to delete cannot be found in your Shopify store. This may be because it was already deleted or because the identifier (ID or title) provided in your import is incorrect.
DISC003 - Shopify API Refused to Save Discount
The Shopify API rejected the discount data and refused to save it. This typically occurs when the discount configuration violates Shopify's business rules or contains invalid data that passed initial validation but failed at the API level.
DISC004 - Invalid Discount Type
The discount type specified in your import is not valid. The 'Type' column must be one of: 'Amount off Products', 'Amount off Order', 'Free Shipping', 'Buy X Get Y', or empty.
DISC005 - Invalid Discount Method
The discount method specified in your import is not valid. The 'Method' column must be either 'Code', 'Automatic', or empty.
DISC006 - Unsupported Discount Type for Creation
The system attempted to create a discount with a type that is not supported by the discount creation API. This is an internal error that should be reported if encountered.
DISC007 - Invalid Date Format
The date format provided for a discount field (such as start date or end date) is invalid. Expected format is YYYY-MM-DD HH:MM:SS or YYYY-MM-DD.
DISC008 - Invalid Usage Limit
The usage limit value provided for the discount is not a valid number. Usage limits must be whole numbers (integers) indicating how many times the discount can be used.
DISC009 - Unable to Find Discount
The discount with the specified ID could not be found in your Shopify store. This may occur when trying to update or delete a discount that doesn't exist.
DISC010 - Unsupported Discount Type for Deletion
The system tried to delete a discount with a type that is not supported by the deletion API. This is an internal error that should be reported if encountered.
DISC011 - Failed to Add Discount Codes
The system failed to add multiple codes to an existing discount. This typically happens when trying to add duplicate codes or codes that violate Shopify's validation rules.
DISC012 - Invalid Uses Per Order Limit
The 'uses per order limit' value provided for the discount is not a valid number. This field must be a whole number (integer) indicating how many times the discount can be applied within a single order.
DISC013 - Customer Segment Not Found
The customer segment specified in your discount cannot be found in your Shopify store. Make sure the segment name matches exactly and that the segment exists in your store.
DISC014 - Customer Not Found
The customer with the specified email address cannot be found in your Shopify store. Make sure the email address is correct and that the customer exists in your store.
DISC015 - Discount Type Not Found in Data
The system could not determine the discount type from the provided data. This is an internal error that should be reported if encountered.
DISC016 - Unsupported Discount Type for Update
The system attempted to update a discount with a type that is not supported by the discount update API. This is an internal error that should be reported if encountered.
DISC017 - Discounts Import in Beta
Importing discounts is still in beta. Please test with 1 or 2 discounts first to ensure everything works as expected before importing larger datasets.
DISC018 - Discount Type Not Specified
The discount type was not specified in the import data. Make sure your import includes the discount type information or that existing discounts have their type properly identified.
DISC019 - Value Must Be a Number
The discount value must be a valid number. This error occurs when the 'Value' column contains text or other non-numeric values that cannot be converted to numbers. For percentage discounts, use a numeric value (e.g., 10.00 for 10% off). For fixed amount discounts, use the monetary value without currency symbols (e.g., 25.00 for $25 off). Ensure all values in the 'Value' column are either empty or contain only numeric values.
Numbers should use a period (not comma) for decimal separation and should not include thousands separators. For example, use 1234.66
instead of 1,234.66
or 1234,66
.
File Codes
Error and warning codes for importing and exporting files.
FILE001 - Shopify Trial Limitation
In some situations stores that are on a Shopify Trial are not able to upload files through the API. This is related to the store's subscription to Shopify, it has nothing to do with being on a paid or free plan with Altera. If your files fail to upload you will need to either switch to a paid Shopify plan or reach out to Shopify support for more help. In some situations this also applies to uploading images when you create new products.
FILE002 - Unable to Find File to Delete
The file you are trying to delete cannot be found in your Shopify store. This may be because it was already deleted or because the identifier (ID or filename) provided in your import is incorrect.
FILE003 - File Already Exists
The file you are trying to create with a MERGE command already exists in your Shopify store. If you want to update an existing file, you must include the 'Alt' column to modify its alt text. To replace the file entirely, use the REPLACE command instead.
Job Codes
Codes related to creating and managing import or export jobs.
JOB001 - Concurrent Job Limit
In order to provide a reliable service to all users you may have a limit to the number of jobs you can run at the same time. You can either cancel another job or wait for it to finish before starting a new job.
JOB002 - Maximum Scheduled Jobs
You have reached the maximum number of scheduled jobs allowed by your plan. To create a new scheduled job, you'll need to either disable an existing scheduled job or upgrade your plan for a higher scheduled job limit.
Menu Codes
Error and warning codes for importing and exporting menus.
MENU001 - No menu items
When you import menus you need to have menu item columns like "Menu Item: Resource Type" and "Menu Item: Title". To get these columns in an export, make sure that you select the 'General' and 'Menu items' groups when configuring which fields to export.
Metafield Definition Codes
Error and warning codes for importing and exporting metafield definitions.
MDEF001 - Unable to Create Metafield Definition
The Shopify API did not return a newly-created metafield definition, possibly because a matching one already exists on the store.
MDEF002 - Unable to Delete Metafield Definition
The metafield definition could not be deleted. This may be because the metafield definition was already removed.
MDEF003 - Shopify Namespaces Cannot be Modified
Certain namespaces like shopify
and shopify--discovery--product_search_boost
are protected namespaces that belong to Shopify proper. Third-party apps are not allowed to update these metafield definitions through the API. This often occurs when trying to import metafield definitions for Shopify Product Category Metafields. Unfortunately at this time those still need to be created manually within the Shopify admin.
MDEF004 - Required Column Missing
Required columns are missing from your metafield definition import. For metafield definitions to import correctly, your spreadsheet must include both 'Type: Name' and 'Namespace' columns. These fields are necessary for Shopify to properly create the metafield definitions.
MDEF005 - Type Column Naming
The column for specifying the metafield type should be named 'Type: Name', not just 'Type'. Please rename this column in your spreadsheet before importing.
Metafield Value Codes
Error and warning codes related to metafield values during imports.
MFLD001 - Invalid Metafield Value
The value provided for a metafield could not be saved to Shopify because it doesn't match the expected format or validation rules for that metafield. This commonly happens when:
The metafield value does not match the type defined in the metafield definition (e.g., providing text for a number field)
The format of a complex value like JSON or reference is incorrect
A required value is missing or empty
The value exceeds Shopify's size limits for that type of metafield
To resolve this issue, check that the metafield value conforms to the requirements of its definition in your Shopify store. You may need to view the metafield definition in Shopify admin to verify the expected type and format.
Metaobject Codes
Error and warning codes that occur when dealing with metaobject imports and operations.
MOBJ001 - Definition Handle Required
The 'Definition: Handle' column is required for metaobject imports and cannot be empty. This column specifies which metaobject definition the imported data should use. Make sure your import file includes the 'Definition: Handle' column with valid metaobject definition handles for all rows containing metaobject data.
Catalog Codes
Error and warning codes that occur when dealing with catalog imports and operations.
CATA001 - Catalog Already Exists
The catalog you are trying to create with the NEW command already exists in your Shopify store. If you want to update an existing catalog, use the MERGE or REPLACE command instead.
CATA002 - Unable to Find Catalog to Delete
The catalog you are trying to delete cannot be found in your Shopify store. This may be because it was already deleted or because the identifier (ID or title) provided in your import is incorrect.
CATA003 - Shopify API Refused to Save Catalog
The Shopify API rejected the catalog data and refused to save it during an update operation. This typically occurs when the catalog configuration violates Shopify's business rules or contains invalid data that passed initial validation but failed at the API level.
CATA004 - Unable to Find Market
The market specified in your catalog import cannot be found in your Shopify store. Make sure the market handle matches exactly and that the market exists in your store. Check that the market is properly configured and active.
CATA005 - Unable to Find Company Location
The company location specified in your catalog import cannot be found in your Shopify store. Make sure the company location name matches exactly and that the location exists in your store. Verify that the company location is properly set up in your B2B configuration.
CATA006 - Failed to Create Price List
The system failed to create a price list for the catalog. This typically happens when there are issues with the price list configuration or when Shopify's API rejects the price list data. Check your price list settings including currency, name, and any parent adjustment configurations.
CATA007 - Cannot Change Publication ID
You cannot change the publication ID of an existing catalog during an update operation. The publication ID is set when the catalog is created and cannot be modified afterward. If you need to change the publication association, you may need to replace the catalog entirely using the REPLACE command.
CATA008 - Shopify API Refused to Create Catalog
The Shopify API rejected the catalog data and refused to create the catalog. This typically occurs when the catalog configuration violates Shopify's business rules or contains invalid data that passed initial validation but failed at the API level during creation.
CATA009 - No Price List Found After Creation
After creating a catalog, the system could not find the associated price list that should have been created. This is an internal error that indicates an issue with the catalog creation process. Please try again or contact support if the problem persists.
CATA010 - Type and Type Values Required
The 'Type' and 'Type Values' fields are required when creating a catalog. These fields determine the context of the catalog (such as which markets or company locations it applies to). Make sure your import includes both the catalog type (e.g., "Market" or "Company Location") and the corresponding values (e.g., market handles or location names).
CATA011 - Catalogs for Apps Not Supported
Catalogs for sales channels/apps cannot be created through the API. Only catalogs for markets and company locations are supported. If you need to create catalogs for apps or sales channels, you'll need to do this manually through the Shopify admin interface.
Company Codes
Error and warning codes that occur when dealing with company imports and operations.
COMP001 - Failed to Create Company
The system failed to create a new company due to an error from the Shopify API. This typically occurs when the company data violates Shopify's business rules or contains invalid information. Check the detailed error message for specific issues with your company data, such as missing required fields or invalid values.
COMP002 - Failed to Update Company
The system failed to update an existing company due to an error from the Shopify API. This typically occurs when the updated company data violates Shopify's business rules or contains invalid information. Check the detailed error message for specific issues with your company data.
COMP003 - Failed to Delete Company
The system failed to delete a company due to an error from the Shopify API. This may occur if the company has associated data that prevents deletion or if there are business rule violations. Check the detailed error message for specific information about why the deletion failed.
COMP004 - Company Already Exists
The company you are trying to create with the NEW command already exists in your Shopify store. If you want to update an existing company, use the MERGE or REPLACE command instead.
COMP005 - Unable to Find Company to Delete
The company you are trying to delete cannot be found in your Shopify store. This may be because it was already deleted or because the identifier (ID or name) provided in your import is incorrect.
COMP006 - Shopify API Refused to Save Company
The Shopify API rejected the company data and refused to save it during an update operation. This typically occurs when the company configuration violates Shopify's business rules or contains invalid data that passed initial validation but failed at the API level.
COMP007 - Companies Import Not Supported
We're still working on importing companies. Please get in touch if you need more information about when this feature will be available or if you have specific requirements for company data imports.
Blog Post Codes
These codes are related to uploading blog posts (articles) and blogs.
BLG001 - Invalid Image URL
The image for a blog post needs to be a complete URL that starts with http://
or https://
.
BLG002 - 'Blog: Handle' Column Required
Shopify needs to associate all blog posts with a blog on your store. If you are unsure of what to set this to, just add the 'Blog: Handle' column to your spreadsheet with the values 'blog' in each row.
BLG003 - Only One Image URL Supported
Shopify blog posts only support one featured image, but you can include additional images in the body HTML of your post. This warning is raised if there's commas or pipe characters in the Image Src column because those are often used to separate different URLs.
BLG004 - Published Date Before 1970
Shopify does not accept blog post dates before January 1, 1970 (the Unix epoch). If you have blog posts with dates before this, you'll need to update them to a valid date range. This limitation is due to how Shopify handles date storage internally.
BLG005 - Published Date Too Far in Future
The published date is more than 10 years in the future, which might indicate a data entry error. While Shopify may accept future dates, having dates too far in the future could cause unexpected behavior or indicate that the year was entered incorrectly (e.g., typing 2224 instead of 2024).
BLG006 - Invalid Published Date Format
The 'Published At' column contains a value that cannot be parsed as a valid date/time. The date should be in a standard format that can be recognized, such as:
2024-01-15
2024-01-15 14:30:00
Jan 15, 2024 2:30 PM
2024/01/15
Make sure all values in the 'Published At' column are either empty (for drafts) or contain properly formatted date/time values.
Object Codes
These codes occur when trying to figure out which kind of Shopify object you are importing or exporting (e.g., products, orders etc..)
OBJ001 – Unknown Export Type
When trying to export objects, the provided object type wasn't recognized. Ensure you're using a valid object type (e.g., products or orders).
OBJ002 – No Matching Type
Sheet analysis didn't find a matching type for the label. Double-check your sheet configurations or labels before importing.
OBJ003 – Unknown Import Type
You tried to import using an object slug that isn't supported. Confirm it's a valid import type (e.g., products, customers).
OBJ004 – Invalid Reference Handle
A metafield reference value didn't start with gid://shopify/
, so it couldn't be processed. Check that all reference handles match the expected gid://shopify/
format.
Draft Order Codes
Error and warning codes that occur when dealing with draft order imports and operations.
DRFT001 - Draft Orders Import Not Yet Available
We're still working on importing draft orders. Please email us if you need more information about when this feature will be available or if you have specific requirements for draft order imports.
DRFT002 - Unable to Find Draft Order to Delete
The draft order you are trying to delete cannot be found in your Shopify store. This may be because it was already deleted or because the identifier (ID or name) provided in your import is incorrect.
DRFT003 - Shopify API Refused to Save Draft Order
The Shopify API rejected the draft order data and refused to save it during a creation operation. This typically occurs when the draft order configuration violates Shopify's business rules or contains invalid data that passed initial validation but failed at the API level.
DRFT004 - Draft Order is Completed - Only Tags Can Be Updated
You are trying to update a draft order that has already been completed (converted to a real order). Completed draft orders are locked and only their tags can be modified. Other changes require creating a new draft order.
DRFT005 - Shopify API Refused to Update Draft Order
The Shopify API rejected the draft order data and refused to update it. This typically occurs when the updated draft order configuration violates Shopify's business rules or contains invalid data that passed initial validation but failed at the API level.
DRFT006 - Invalid Email Format
The email address provided for the draft order is not in a valid format. Email addresses must follow the standard email format (e.g., [email protected]). Please check the email field and ensure it contains a properly formatted email address.
DRFT007 - Invalid Date Format for Reserve Inventory Until
The date format provided for the 'Reserve Inventory Until' field is invalid. Expected format is YYYY-MM-DD HH:MM:SS or YYYY-MM-DD. Please ensure your date values match one of these formats.
DRFT008 - Draft Order Already Exists
The draft order you are trying to create with the NEW command already exists in your Shopify store. If you want to update an existing draft order, use the MERGE or REPLACE command instead. Note: Draft orders importing is currently in development - please contact us for more information.
Order Codes
Error and warning codes that occur when dealing with orders
ORD001 - ID or Name Required
All order sheets need to have either a Name
or ID
column to be able to group orders that span multiple rows
ORD002 - Required Column Missing
Required columns, such as the Line: Type
column are missing from the source file.
ORD003 - Invalid 'Line: Type' Column
The Line: Type
column must be one of these values:
Line Item
Discount
Shipping Line
Transaction
Refund Line
Refund Shipping
Fulfillment Line
Ignore
ORD004 - Order Importing in Beta
Importing orders is still in beta. We recommend testing your imports first with a smaller sample of your file. Please let us know if you encounter any errors.
ORD005 - Order Not Found
The order specified in your import could not be found in your Shopify store. This typically occurs when trying to update or delete an order that doesn't exist, possibly because it was already deleted or the identifier is incorrect.
ORD006 - Editing Orders Not Supported
Editing existing orders is not currently supported through the application. You may need to delete the existing order and create a new one with your desired changes.
ORD007 - Missing Line Item Data
This error occurs when processing a refund with insufficient line item data. When processing refunds, make sure to include all required line item information to properly associate the refund with the correct items.
ORD008 - Trial/Development Store Rate Limit
Shopify limits new orders to 5 per minute on trial and development stores. If your store is on a trial or development plan, order imports will run more slowly due to this limitation. To increase the import speed, consider upgrading to a paid Shopify plan.
ORD009 - Invalid Numeric Value
The numeric columns in your order import ('Line: Quantity', 'Line: Price', 'Transaction: Amount') must contain valid numbers or be left blank. This error occurs when these columns contain text or other non-numeric values that cannot be converted to numbers. Numbers should use a period (not comma) for decimal separation and should not include thousands separators. For example, use 1234.66
instead of 1,234.66
or 1234,66
. Ensure all values in these columns are either empty or contain only numeric values in the correct format.
ORD010 - Invalid Date/Time Value
The date/time columns in your order import ('Processed At', 'Transaction: Processed At', 'Fulfillment: Processed At') must contain valid date/time values or be left blank. This error occurs when these columns contain text or other values that cannot be parsed as valid dates. Use standard date formats like 2024-01-15
, 2024-01-15 14:30:00
, or Jan 15, 2024 2:30 PM
. Ensure all values in these columns are either empty or contain properly formatted date/time values.
Product Codes
Error and warning codes that occur when dealing with product data
PRD001 - Product Not Found
The mentioned product was not found on Shopify. Perhaps is has been deleted.
PRD002 - No Option 1 Values
Products with multiple variants need to have the Option1 Value
column set to identify the different variants.
PRD003 - Invalid Product Status
The product status field must be empty or one of the following: ACTIVE
, ARCHIVED
or DRAFT
.
PRD004 - Duplicate Product Title
The spreadsheet it identifying products by title but more than one product with that title exists in Shopify. A product title needs to be unique when using it to update a product. If you have multiple products with the same title you can either use the ID
or Handle
column to identify the product you want to update.
PRD005 - Weight Should Just be a Number
The Variant Weight
column should just contain a number. If you want to set the unit of the weight you can set that separately in the Variant Weight Unit
column.
PRD006 - Reference Metafields Need GID Format
When importing reference metafields the values need to be in the GID format like gid://shopify/Metaobject/123456789
or ["gid://shopify/Metaobject/123456789"]
if it's a list of references. We are working on adding support for looking up references by handle. Please contact us if you feel this feature should be prioritized.
PRD007 - Option1 Value Column Required
When including an 'Option1 Name' column in your product import, you must also include the corresponding 'Option1 Value' column. Option names define the type of variant (like "Size" or "Color"), while option values define the specific variants (like "Small" or "Red").
PRD008 - Missing Option1 Value
For each product with an 'Option1 Name' defined, you must provide a corresponding value in the 'Option1 Value' column. Empty option values will cause errors when creating variants in Shopify. Ensure all products with option names have corresponding option values set.
PRD009 - Missing Variant Identification Column
When updating variant data, you must include at least one column that identifies which variant to update, such as 'Variant ID', 'Variant SKU', or 'Variant Barcode'. Without an identification column, the system cannot determine which variant should receive the updates. Add one of these columns to your import file to resolve this issue.
PRD010 - Missing Product Title
The product's title is required in each row of your import file. This is necessary for the system to properly group variants belonging to the same product. Make sure every row in your import file has a product title, even when importing multiple variants of the same product.
PRD011 - Invalid Price Format
The price columns ('Variant Price', 'Variant Compare At Price', 'Variant Cost') should contain only plain numbers with a period (not comma) for decimal separation and no currency symbols. For example, use 19.99
instead of $19.99
or 19,99
. This ensures that prices are correctly interpreted by Shopify when imported.
PRD012 - Newlines in Meta Description
The meta description field (Metafield: description_tag [single_line_text_field]
) should not contain newline characters. Newlines in meta descriptions can cause issues with SEO and may not display correctly in search engine results. Altera will attempt to remove any newline characters from this field during import, but it's best to ensure your source data does not include them.
PRD013 - HTML in Meta Description
The meta description field (Metafield: description_tag [single_line_text_field]
) should not contain HTML elements. HTML in meta descriptions is typically stripped by search engines and may cause unexpected display issues in search results. Using plain text in meta descriptions is recommended for better SEO outcomes and proper display across all platforms. Please remove HTML elements like <div>
or <p>
tags from your meta descriptions.
PRD015 - Market Compare-At Price Requires Regular Price
When setting a compare-at price for a specific market, you must also set the regular price for that same market. Shopify requires that any market with a compare-at price must also have a regular price defined. Update your spreadsheet to include the regular price for any markets where you've specified a compare-at price.
PRD016 - Meta Description Too Long
The meta description field (Metafield: description_tag [single_line_text_field]
) exceeds Shopify's recommended maximum length of 160 characters. While longer descriptions will be imported, search engines typically truncate meta descriptions to around 155-160 characters. For optimal SEO performance, keep your meta descriptions concise and within the recommended length to ensure they display properly in search results.
PRD017 - Meta Title Too Long
The meta title field (Metafield: title_tag [single_line_text_field]
) exceeds Shopify's recommended maximum length of 70 characters. While longer titles will be imported, search engines typically display only the first 50-60 characters of meta titles in search results. For optimal SEO performance, keep your meta titles concise and within the recommended length to ensure they display properly in search results.
PRD018 - Missing Product Title
A title is required to create a new product. This error occurs when trying to create a product without providing a title field. This may also happen when trying to update products by SKU where the SKU doesn't exist on the store. In such cases, the system tries to create a new product but fails because there's no title provided in the import data.
If you are creating new products, ensure that each product row in your import file includes a 'Title' column with the product's name. If you are updating existing products by SKU you can ignore this error if you know that not all SKUs in your import file exist on the store.
PRD019 - Invalid Unit Price Format
The unit price data in the 'Variant Unit Price' column is not in the correct format. Unit price must be either blank or a valid JSON object with the following structure:
json { "quantityUnit": "G", "quantityValue": 12.0, "referenceUnit": "KG", "referenceValue": 1 }
The valid units are: CL, CM, FLOZ, FT, FT2, G, GAL, IN, ITEM, KG, L, LB, M, M2, M3, MG, ML, MM, OZ, PT, QT.
Both quantityValue
and referenceValue
must be numeric. The quantityValue
can be a decimal number, but referenceValue
must be a whole number (though 2.0 is acceptable and will be converted to 2).
Remote File Download Codes
Error codes that appear when downloading files from remote sources (HTTP, FTP, Google Drive, etc.)
REM001 - Unsupported URL Scheme
The URL scheme is not supported. Currently supported schemes are HTTP, HTTPS, and FTP.
REM002 - Invalid URL Format
The URL format is invalid for the specified source type. Make sure you've entered a valid URL.
REM003 - File Not Found
The file was not found at the specified URL. Please check that the URL is correct and the file exists.
REM004 - Access Denied
Authentication is required or you have insufficient permissions to access the file. Check if the file requires login or specific permissions.
REM005 - HTTP Error
An HTTP error occurred when trying to download the file. This could be due to server problems or invalid requests.
REM006 - Empty File
The downloaded file is empty (zero bytes). Please check the source file.
REM007 - Connection Error
Failed to connect to the server. Check your internet connection and verify the URL is correct.
REM008 - Connection Timeout
The connection timed out while trying to download the file. This could be due to a slow connection or server issues.
REM009 - Download Failed
The file download failed due to a general request error. Check the detailed error message for more information.
REM010 - Unexpected Error During HTTP Download
An unexpected error occurred during the HTTP download. Check the logs for more details.
REM011 - FTP Connection Failed
Failed to connect to the FTP server. Check that the server address is correct and the server is running.
REM012 - FTP Authentication Failed
Authentication failed for the FTP server. Verify your username and password.
REM013 - FTP File Access Error
Unable to access the file on the FTP server. The file may not exist or you might not have permission to access it.
REM014 - FTP Transfer Error
An error occurred during the FTP file transfer. Check your connection and try again.
REM015 - Empty FTP File
The downloaded FTP file is empty (zero bytes). Please check the source file.
REM016 - General FTP Error
A general FTP error occurred. Check the detailed error message for more information.
REM017 - Unexpected Error During FTP Download
An unexpected error occurred during the FTP download. Check the logs for more details.
REM018 - Google Drive File ID Extraction Error
Could not extract the file ID from the Google Drive URL. Make sure you're using a valid Google Drive sharing URL.
REM019 - Google Drive File Not Found
The file was not found on Google Drive. It may have been deleted or you don't have permission to access it.
REM020 - Google Drive Access Denied
Access was denied to the Google Drive file. Make sure the file is shared publicly or with anyone who has the link.
REM021 - Google Drive Authentication Required
The file requires authentication. Make sure the file is shared with the appropriate permissions.
REM022 - Google Drive Access Error
Failed to access the Google Drive file. Check the detailed error message for more information.
REM023 - Google Drive Large File Confirmation Error
Failed to confirm the download of a large Google Drive file. Try again or download a smaller file.
REM024 - Google Drive HTML Response
Received HTML instead of file data from Google Drive. The file may require login or have sharing restrictions.
REM025 - Empty Google Drive File
The downloaded Google Drive file is empty (zero bytes). Please check the source file.
REM026 - Google Drive Connection Error
Failed to connect to Google Drive. Check your internet connection.
REM027 - Google Drive Download Failed
The Google Drive file download failed. Check the detailed error message for more information.
REM028 - Unexpected Error During Google Drive Download
An unexpected error occurred during the Google Drive download. Check the logs for more details.
REM029 - OneDrive File ID Extraction Error
Could not extract the file ID from the OneDrive URL. Make sure you're using a valid OneDrive sharing URL.
REM030 - OneDrive File Not Found
The file was not found on OneDrive. It may have been deleted or you don't have permission to access it.
REM031 - OneDrive Access Denied
Access was denied to the OneDrive file. Make sure the file is shared publicly or with anyone who has the link.
REM032 - OneDrive Authentication Required
The file requires authentication. Make sure the file is shared with the appropriate permissions.
REM033 - OneDrive Access Error
Failed to access the OneDrive file. Check the detailed error message for more information.
REM034 - OneDrive Download Failed
The OneDrive file download failed. Check the detailed error message for more information.
REM035 - Empty OneDrive File
The downloaded OneDrive file is empty (zero bytes). Please check the source file.
REM036 - Dropbox File ID Extraction Error
Could not extract the file ID from the Dropbox URL. Make sure you're using a valid Dropbox sharing URL.
REM037 - Dropbox File Not Found
The file was not found on Dropbox. It may have been deleted or you don't have permission to access it.
REM038 - Dropbox Access Denied
Access was denied to the Dropbox file. Make sure the file is shared publicly or with anyone who has the link.
REM039 - Dropbox Authentication Required
The file requires authentication. Make sure the file is shared with the appropriate permissions.
REM040 - Dropbox Access Error
Failed to access the Dropbox file. Check the detailed error message for more information.
REM041 - Dropbox Download Failed
The Dropbox file download failed. Check the detailed error message for more information.
REM042 - Empty Dropbox File
The downloaded Dropbox file is empty (zero bytes). Please check the source file.
REM043 - SFTP Connection Failed
Failed to connect to the SFTP server. Check that the server address is correct and the server is running.
REM044 - SFTP Authentication Failed
Authentication failed for the SFTP server. Verify your username, password or key file.
REM045 - SFTP File Access Error
Unable to access the file on the SFTP server. The file may not exist or you might not have permission to access it.
REM046 - SFTP Transfer Error
An error occurred during the SFTP file transfer. Check your connection and try again.
REM047 - Empty SFTP File
The downloaded SFTP file is empty (zero bytes). Please check the source file.
REM048 - S3 Bucket Access Error
Failed to access the S3 bucket. Verify your credentials and bucket permissions.
REM049 - S3 Object Not Found
The requested object was not found in the S3 bucket. Check that the path and bucket name are correct.
REM050 - S3 Authentication Error
Authentication failed for the S3 service. Verify your AWS credentials are correct.
REM051 - S3 Download Failed
The S3 file download failed. Check the detailed error message for more information.
REM052 - Empty S3 File
The downloaded S3 file is empty (zero bytes). Please check the source file.
REM053 - Azure Blob Storage Access Error
Failed to access the Azure Blob Storage container. Verify your credentials and container permissions.
REM054 - Azure Blob Not Found
The requested blob was not found in Azure Storage. Check that the path and container name are correct.
REM055 - Azure Authentication Error
Authentication failed for the Azure Blob Storage. Verify your connection string or SAS token is correct.
REM056 - Azure Download Failed
The Azure blob download failed. Check the detailed error message for more information.
REM057 - Empty Azure Blob
The downloaded Azure blob is empty (zero bytes). Please check the source blob.
REM058 - File Format Not Supported
The downloaded file is in a format that is not supported for importing. Please check our documentation for supported file formats.
REM059 - File Size Limit Exceeded
The remote file exceeds the maximum allowed file size. Please try with a smaller file or contact support for assistance.
REM060 - Rate Limit Exceeded
Rate limit exceeded when accessing the remote file. Please try again later or with a different source.
REM999 - Unhandled Remote File Error
An unhandled error occurred during the remote file download process. This is a general error code for unexpected issues.
Spreadsheet Writing Codes
These codes occur when the app is writing your output to a spreadsheet
WRT001 – Unknown Object Type
You attempted to export using a data type the system doesn't recognize. Please try to reconfigure the job and run it again.
WRT002 – Unknown Export Type
The export format is not recognized. Currently Altera only supports CSV and Excel files in the Altera/Matrixify format.
Shopify API Codes
These codes occur when interacting with the Shopify API.
SAPI008 - Shopify API Error
An error was returned from the Shopify API that was not related to internal server issues or product modification conflicts. This could be due to various reasons such as invalid data, API limitations, or other Shopify-specific constraints. The exact error message from Shopify will be provided with this code to help diagnose the specific issue.
User Error Codes
These codes appear when Shopify rejects an operation due to validation issues or business rule violations.
USR001 - Shopify Validation Error
This error occurs when Shopify rejects the data you're trying to submit because it doesn't meet their requirements. Unlike technical API errors, these are usually related to the actual content of your data.
Common reasons for this error include:
Missing required fields (e.g., a product without a title)
Invalid data formats (e.g., incorrect date format)
Business rule violations (e.g., trying to set a price lower than allowed)
Duplicate data (e.g., attempting to create a product with an existing SKU)
Resource constraints (e.g., exceeding allowed inventory levels)
The error message accompanying this code will provide specific details about what went wrong, which should help you correct your data before trying again.