Skip to main content

Frequently Asked Questions (FAQ)

Common questions and answers about using Altera for Shopify data import and export

Updated yesterday

General Features

What are the differences between Altera and Matrixify?

Both Altera and Matrixify are Shopify apps for importing and exporting data via spreadsheets. Altera offers additional data types (like Catalogs and Metafield Definitions), enhanced features such as running multiple jobs simultaneously and automatic data transformations, plus support for additional fields like customer store credit and payment terms.

For a complete comparison, read our differences between Altera and Matrixify article.

What types of data can I import and export?

Altera supports the following data types:

  • Products (including variants, images, metafields, and SEO data)

  • Collections (both smart and manual collections)

  • Customers (contact information, addresses, and customer metafields)

  • Orders (order details, line items, and fulfillment information)

  • Discounts (automatic and code-based discount rules)

  • Articles (blog posts and content)

  • Catalogs (product catalogs and organization)

  • Companies (B2B company information, importing under development)

  • Draft Orders (incomplete orders and quotes)

  • Files (media files and documents)

  • Locations (store locations and fulfillment centers)

  • Menus (navigation menus and structure)

  • Metaobjects (custom data structures and content)

  • Pages (store pages and static content)

  • Redirects (URL redirections and SEO management)

  • Shop (store settings and configuration)

  • Metafield Definitions (custom field schemas and definitions)

  • Metaobject Definitions (custom object types)

Export-only data types:

  • Events (store activity and audit logs)

  • Payouts (payment settlement information)

  • Translations (multilingual content for products, collections, and more)

What file formats does Altera support?

Altera works with:

  • Excel files (.xlsx, .xls)

  • CSV files (.csv)

  • Google Sheets (export directly to a Google Sheet, or import via published URL)

  • Google Drive (export files to Google Drive, or import spreadsheets from Google Drive)

Can I import data from other platforms like WooCommerce?

Yes! Altera can import data from any platform as long as you can export it to a supported spreadsheet format. You may need to adjust column headers to match Shopify's requirements, but the app provides guidance during the upload process. Additionally, we are developing an API connector with WooCommerce to avoid the need to reformat a spreadsheet.

Can Altera import custom spreadsheet formats or XML feeds?

No, Altera only imports files that are formatted in the Altera/Matrixify spreadsheet format. We do not support importing:

  • Custom spreadsheet formats or proprietary layouts

  • XML documents or product feeds

  • Supplier feeds that do not match the Altera format

  • Marketplace exports in non-standard formats

If you need to transform data from a custom format or sync inventory from supplier feeds, consider using these apps:

  • syncX: Stock Sync - Automates inventory updates from multiple suppliers and supports CSV, XML, FTP, and custom formats

  • Stockistly - Syncs inventory from suppliers using CSV, XML, FTP, API, and other formats

These apps specialize in importing data from various sources and formats. Once your data is in Shopify, you can use Altera to export it in the correct format for bulk updates and advanced data transformations.

For spreadsheet reformatting for exports, see our Data Transformations feature.

Is Altera a "Built for Shopify" app?

Yes - Altera is "Built for Shopify". We meet Shopify's app quality standards for usability, performance, and security. You'll see the Built for Shopify badge on our Shopify App Store listing and within the app. For you, this means a faster, more reliable, and secure experience that feels native to Shopify. We proactively track API changes to keep your workflows stable.

How fast is Altera? Can it handle large stores?

Yes! We can comfortably process jobs over a million records. Altera runs imports and exports in parallel whenever possible, which means multiple items are processed at the same time instead of one by one. For example, updating inventory levels for 10,000 products took under 10 minutes in our tests. Your results may vary depending on which fields you're updating, your Shopify plan, and other factors.

And we don't throttle processing speed based on your plan. Whether you're on our free Community plan or a paid plan, your jobs run at the same speed.

If you need faster imports, try including only the fields you need to update. Fewer fields means less data to process. If you're still running into speed issues, reach out to us and we'll help optimize your workflow.


Import Questions

How do I know if my import was successful?

After each import, Altera provides a detailed results file that shows:

  • Import Result column indicating success or failure for each row

  • Import Comment column with specific error messages if something went wrong

  • ID (Ref) and Handle (Ref) columns showing the Shopify IDs for successfully created items

What happens if my import fails partway through?

Altera processes imports row by row, so if some rows fail, the successful ones remain in your store. You can download the results file to see exactly which items failed and why, then fix the issues and re-import just the failed rows.

Can I update existing products with an import?

Yes! If your spreadsheet includes a Handle or ID column with existing product identifiers, Altera will update those products instead of creating new ones. This is perfect for bulk price updates or inventory adjustments.

How large can my import files be?

Altera can handle files with thousands of rows. For very large imports the process may take a while but you can monitor progress in real-time on the job detail screen. Currently file uploads are capped at 250mb but contact us if you need to import larger files.

Where can I find sample files?

Sample files for some data types are available in our knowledge base. Within the app, you'll find links to relevant knowledge base articles that include sample files and formatting guidance for supported data types. For data types without existing samples, contact support for specific examples.

Can I schedule automatic imports?

Yes! You can schedule imports to run automatically. The scheduling options depend on your import source:

For file uploads (one-time scheduled imports):

  • Upload your file and configure the import settings

  • In the Scheduling section, enable Run on a schedule

  • Choose the date and time when you want the import to run once

  • Perfect for timing imports for specific events (like launching a sale at midnight)

For remote sources (FTP/SFTP/URL - recurring scheduled imports):

  • Connect to an FTP, SFTP server, or remote URL

  • Enable scheduling and choose your repeat interval (daily, weekly, monthly, etc.)

  • Altera will automatically download the latest file and import it at your specified times

Scheduling is available on paid plans.

If you archive a job that has a schedule enabled, it will stop running automatically. This prevents archived jobs from continuing to run in the background when they're not visible in your jobs list.

What happens if a scheduled job is still running when the next run is scheduled?

To prevent issues with overlapping data, Altera will not start a new scheduled run if the previous run is still processing. The scheduled instance will be skipped, and the job will run again at the next scheduled interval. This ensures data integrity and prevents conflicts when importing or exporting large datasets that may take longer than your scheduled interval to complete.

If you notice your scheduled jobs are frequently being skipped, consider:

  • Increasing the time between scheduled runs

  • Reducing the amount of data being processed (using filters)

  • Optimizing your import/export configuration


Export Questions

How often can I export my data?

You can export data as often as needed - there are no limits on export frequency. Each export captures your current store data at the time you run it.

Can I schedule automatic exports?

Yes! You can schedule exports to run automatically at specified intervals (daily, weekly, monthly, etc.) or as one-time scheduled jobs. This feature is available on paid plans.

To schedule an export:

  1. Create a new export and configure your data types and columns

  2. In the Scheduling section, enable Run on a schedule

  3. Choose your start time and repeat interval

  4. The export will run automatically at your specified times

If you archive a job that has a schedule enabled, it will stop running automatically. This prevents archived jobs from continuing to run in the background when they're not visible in your jobs list.

How do field columns work in recurring exports?

When you create a recurring export, the field groups and columns you select are fixed for the lifetime of that export. This ensures consistency in your export files across all runs.

The field columns you configure when creating the export will remain the same for all future runs. If we add new fields to the app later (for example, adding a new variant field to Altera's field configuration), those new fields will not automatically appear in your existing recurring export. To include new fields, you would need to create a new export with the updated configuration.

The exception to this rule is metafield columns. Metafield columns are dynamically generated each time the export runs, based on the metafield definitions currently configured in your Shopify store and any unstructured metafields that exist on your objects (products, variants, customers, etc.).

Metafield columns always appear at the end of your export file, which means they can change from one export run to another as you add or remove metafield definitions or unstructured metafields in your store.

If you need to ensure that all columns (including metafields) appear in exactly the same order every time, contact us to set up a data transformation. Data transformations can be configured to run automatically after each export to ensure the columns match exactly, including maintaining a consistent order for metafield columns across all export runs.

What is URL visibility on the export screen?

When Altera creates an export, it stores the output file at a secure URL. By default, this URL is private - even if someone knows the exact URL, they won't be able to download your data without proper authentication.

However, there are situations where you might want to make the export URL publicly accessible. For example:

  • Google Sheets integration: If you want to import the exported data directly into Google Sheets using a URL

  • Third-party integrations: When connecting exported data to other tools or services

  • Scheduled access: For automated systems that need to fetch the exported data

Important security notes:

  • Even when URLs are made visible, they use complex, randomly generated identifiers that are extremely difficult to guess

  • A typical visible URL looks like: https://files.getaltera.com/output/69473829050/10/10a1e1a6-5eb9-4b84-bce4-4dd408b5ffe4/Shop_Export_2025-06-28_053544.xlsx

  • This feature is particularly useful when combined with scheduled exports

For most users, keeping URLs private (the default setting) is recommended unless you specifically need external access to the export files.

Can I export only specific products or customers?

Yes! When setting up an export, you can apply filters to export only the data you need. For example, you can export only products from a specific vendor, customers from a certain location, or orders from a particular date range.

Can I change the format of my exported spreadsheet?

Yes! Altera offers Data Transformations (currently in early access) that allows you to automatically restructure your exported spreadsheets. Contact support to request access and we'll enable it for your account. With data transformations, you can:

  • Rename columns to match your preferred naming conventions

  • Reorder columns to arrange data in your desired sequence

  • Extract data from one column into separate columns (e.g., extract a specific custom attribute)

  • Combine columns to merge related data

  • Create calculated fields from existing data

To get started with data transformations:

  1. Contact our support team to discuss your transformation needs

  2. Provide examples of your desired output format

  3. Our team will create custom transformation recipes for your use cases

  4. Once configured, you'll see transformation options at the bottom of your export configuration page


Billing & Plans

How does the 30-day money-back guarantee work?

If, at any time, you are not satisfied with Altera, you can cancel your subscription and receive a refund for the last month's charges. Contact our support team to initiate the refund process.

How are refunds processed?

Shopify provides us with two methods to refund app charges:

  • Shopify app store credit

  • Refunding the individual charge to your credit card or bank account

App store credits can be used against any app charge on your Shopify invoice and can be processed within a business day. Note that we do not offer app store credit as a refund for your first month's bill unless that invoice has already been completely paid.

When we refund an individual charge, it can take up to 3-4 business days for the money to appear in your account.

Unfortunately we cannot remove pending charges from a Shopify invoice but we can refund them after they have been paid.

What is the developer plan?

The developer plan is a free plan for Shopify development stores and trial accounts. It provides unlimited imports and exports with no restrictions and the same priority as paid plans. The only limitation is that scheduled/recurring jobs are not available. When your store transitions to a paid Shopify plan, you'll need to switch to a different Altera plan.

Visit our Developer Plan page for more details.

What is the free community plan?

The community plan is a free plan for all Shopify stores. It provides unlimited imports and exports with no restrictions and the same priority as paid plans. The only limitation is that scheduled/recurring jobs are not available. When your store transitions to a paid Shopify plan, you'll need to switch to a different Altera plan.

Visit our Community Plan page for more details.

What is the pro plan?

The pro plan is a paid plan for stores that need higher capacity and automation. It provides unlimited imports and exports with no restrictions and the same priority as paid plans. The only limitation is that scheduled/recurring jobs are not available. When your store transitions to a paid Shopify plan, you'll need to switch to a different Altera plan.

Where can I learn more about the different plans?

Visit our Plans Overview page for more details on the different plans.

Why was I billed after uninstalling the app?

When you uninstall the app your subscription is cancelled immediately however a difference between the app's billing cycle and Shopify's billing cycle may result in a charge on your Shopify invoice. If you were charged unexpectedly, please reach out to us and we'll refund the charges.

Do I need subscriptions to both stores when moving data from one store to another?

Yes, you'll need Altera installed on both stores - one to export the data and one to import it. However, there are several ways to keep costs down:

Development stores are completely free

If either of your stores is a Shopify development store, you can use Altera with no limits and no subscription. There's no cap on how many rows you can export or import.

The Community Plan offers generous free limits

Our Community Plan (free tier) allows you to work with up to 100 objects per file. This is significantly higher than comparable apps, which typically limit you to 10-50 items on free plans. For smaller catalogs or testing your migration, this might be all you need.

Two paid subscriptions can still be more affordable

Even if you need paid plans on both stores, two subscriptions at $15/month each ($30 total) is often cheaper than alternatives like Matrixify, especially for stores with moderate data needs. You only need to maintain both subscriptions during your data migration period - once complete, you can cancel the subscription on the old store.

Tips for cost-effective migrations:

  • If possible, keep one store as a development store during the transition

  • Plan your migration to complete within a single billing cycle

  • Use the Community Plan first to test your import process

  • Only upgrade to a paid plan when you're ready for the full migration

Troubleshooting

Why can't I upload an order or product export from Shopify admin?

Order and product exports from Shopify's admin are formatted differently than the import format Altera expects. If you try to upload these files directly, the import may fail or only partially succeed because critical fields are missing or structured differently.

Solution 1 - Export directly from the source store (Recommended):

If you still have access to the original Shopify store, install Altera on that store and export the data directly. This ensures the file is in the correct format for importing to another store.

Solution 2 - Use Data Transformations:

If you already have a Shopify admin export and can't access the original store:

  1. Go to the Transform Data section in Altera

  2. Upload your Shopify admin export file

  3. Select the appropriate transformation:

  4. Shopify Admin Products Export → Altera Format for product files

  5. Shopify Admin Orders Export → Altera Format for order files

  6. Download the transformed file

  7. Import the transformed file into Altera

Learn more about Data Transformations.

Why are some of my products not importing?

Common reasons include:

  • Missing required fields: Products need at least a Title to be created

  • Invalid data formats: Check that prices are numbers, dates are properly formatted, etc.

  • Duplicate handles: Product handles must be unique across your store

  • Character limits: Ensure descriptions and titles don't exceed Shopify's limits

The results file will show specific error messages for each failed import.

My import is taking a long time. Is something wrong?

Large imports naturally take time to process. Altera shows real-time progress, so you can see items being processed. If an import appears stuck without progress for more than 10 minutes, contact support.

What's the longest a job can take?

Jobs may be terminated after 10 days, though most jobs complete far faster than that. If your job is taking an unusually long time, we recommend:

  • Contact us for optimization help: Our support team can analyze your job and suggest ways to speed up processing

  • Split into smaller jobs: Breaking a large import or export into several smaller files often results in faster overall completion and makes it easier to track progress

If you're regularly working with very large datasets, reach out to us and we'll help you find the most efficient approach for your specific use case.

Why is my job stuck in the "pending" state?

If your job appears to be stuck in the pending state, this is likely a temporary issue due to a high volume of jobs being processed simultaneously. Jobs are processed in the order they are received, so during busy periods, there may be a queue of jobs waiting to start.

This is normal behavior and your job will begin processing once the jobs ahead of it in the queue are completed. Please be patient - your job should start and complete successfully without any action needed on your part.

Why is my job showing an 'error' status?

First of all, we're sorry the didn't complete successfully. If your job shows an 'error' status, it means something unexpected prevented the job from completing successfully. This can happen for several reasons:

  • Data formatting issues: Unexpected formatting in your spreadsheet that doesn't match the expected structure

  • Shopify API problems: Temporary issues with Shopify's API that prevent data from being processed

  • System errors: Technical issues on our end that interrupt the processing

When a job shows an 'error' status, please try the following steps:

  • Check your data formatting: Review your spreadsheet to ensure all data follows the correct format and required fields are present

  • Retry the import: Sometimes temporary API issues resolve themselves, so you can try uploading your file again

  • Contact support: If the error persists, please contact our support team with details about your import and we'll investigate the specific issue

Can I cancel an import that's already running?

Yes! You can cancel an import while it's running. You can monitor real-time progress on the job detail screen and stop the import if needed. Any items that have already been processed will remain in your store.

I made a mistake in my import. Can I undo it?

Altera doesn't have an automatic undo feature, but you can:

  • Use the results file to identify what was imported

  • Export the imported data and manually delete unwanted items

  • Contact support for assistance with large-scale corrections

Can I export metaobject entries from Shopify Forms?

Unfortunately, it's not possible to export metaobject entries created by the Shopify Forms app through the Shopify API. While you can see these metaobjects in your Shopify admin, they are marked as read-only and their definitions are not accessible via the API that Altera uses to retrieve data.

This is a limitation imposed by Shopify, not Altera. According to discussions in the Shopify developer forums, Shopify Forms metaobject definitions used to be returned by the API but are no longer available. This means that apps like Altera cannot access form submission data through the standard API endpoints.


Data Format Questions

How should I format my spreadsheet for importing?

  • Use clear column headers that match Matrixify/Altera field names (Title, Handle, Body HTML, etc.)

  • Keep data consistent within each column (all prices as numbers, all dates in the same format)

  • Name your sheet tab appropriately (Products, Collections, etc.) to help with automatic detection

  • Review our sample files for examples of proper formatting

Can I include images in my imports?

Yes! You can include product images by:

  • Image URLs: Include columns like Image Src with direct URLs to images

  • Multiple images: Use separate columns (Image Src, Image Src 2, etc.) for multiple product images

  • Alt text: Include Image Alt Text columns for accessibility

How do I handle product variants in imports?

Product variants should be on separate rows in your spreadsheet. Include:

  • The same Title for all variants of a product

  • Different Option1 Name, Option1 Value (and Option2, Option3 if needed) for each variant

  • Unique SKU and Barcode for each variant if applicable

Does Altera support importing and exporting translations?

Yes! Altera supports exporting translations for products, collections, pages, metaobjects, and other Shopify resources. The exported files are compatible with Shopify's native translation import, plus we include extra columns (like handles and parent resource info) to help you identify what you're translating.

You can filter exports by locale, resource type, and for product-related content, by product status, tag, or creation date.

Translation imports are planned for a future update. For now, you can edit exported files and import them directly into Shopify's admin at Settings > Languages.

See our Translations reference for full details on available fields and filters.

Does Altera support importing and exporting shipping profiles?

No, Altera doesn't currently support importing or exporting shipping profiles. Shipping profiles allow you to configure different shipping rates and options for different products in your store, but this data isn't available through our import/export process yet.

If this is a feature you need, contact us and we can notify you when we add support for shipping profiles.

Why does the phone number in my export look different from the Shopify admin?

Altera exports phone numbers exactly as they're stored in the Shopify API. The Shopify admin applies additional formatting code to display phone numbers in a standardized, human-readable format - but this formatting isn't part of the raw data.

As a result, a phone number that appears as +1 (555) 123-4567 in the Shopify admin might export as '+15551234567 or +15551234567 in your spreadsheet.

If you want your exported phone numbers in a standardized format, you can enable phone number formatting in the Advanced Options section when creating an export. The available formats are:

  • Default from Shopify API - Pass through as-is (no formatting)

  • Strict international - E.164 format (e.g., +15551234567)

  • Readable international - Spaced international format (e.g., +1 555 123 4567)

  • National format - Local format without country code (e.g., (555) 123-4567)

When formatting is enabled, Altera uses the country code from the associated address (customer address, shipping address, etc.) to accurately parse and format the phone number.


Data Retention & Privacy

How long does Altera keep my uploaded and exported files?

By default, we keep all uploaded files and exported data for 180 days from the date they were created. This gives you plenty of time to download exports and review import results. If you need longer retention for compliance or business reasons, contact us to discuss extended retention periods.

What happens to my data when I uninstall the app?

All files are permanently deleted within 48 hours after you uninstall Altera, in accordance with Shopify's data protection policy. Make sure to download any important files before uninstalling - once deleted, we cannot recover them.

Can I get my files deleted sooner than 180 days?

Yes! If you want files removed before the standard retention period, just contact our support team and we'll delete them immediately.

Did this answer your question?