image 1
image 2
image 3
Openmage
Craft commerce
Circles image
Step-by-Step Migration Guide

Openmage to Craft commerce

Migrating your store from Openmage to Craft commerce might seem daunting, but with proper planning and the right tools, it's a smooth process. Follow this step-by-step guide to ensure a successful transition.

Schedule a call
Background image
Guide Overview

Step-by-Step Migration Guide: OpenMage to Craft Commerce Migration Guide

Step 1: Preparing Your OpenMage Environment

Before embarking on the migration journey from OpenMage to Craft Commerce, it is essential to prepare your OpenMage environment thoroughly. This preparation phase is vital for a smooth transition, minimizing potential issues that can arise during the migration process.

Firstly, we need to conduct a comprehensive assessment of your existing OpenMage setup. This includes reviewing your current extensions, themes, and customizations, ensuring that they are compatible with the new Craft Commerce platform. Not all features in OpenMage will have direct equivalents in Craft Commerce, so identifying gaps early will aid in planning for adjustments needed post-migration.

Next, we'll create a complete backup of your OpenMage store. This backup should include:

  • Database: Utilize tools like phpMyAdmin or command-line MySQL to export your database securely.
  • Media Files: Archive all media files, including product images and downloadable content, to prevent data loss.
  • Configuration Files: Back up configuration files located in the app/etc directory, as these contain critical environment settings.

Once the backup is complete, verify the integrity of the backup files to ensure they are not corrupted. This verification is crucial as it will provide a safety net should any issues occur during the migration process.

Finally, assess the hosting environment of your OpenMage store. Ensure that your hosting provider supports Craft Commerce's requirements, including PHP versions and database types. Craft Commerce typically requires a more modern setup, so plan for any necessary upgrades.

Step 2: Installing Craft Commerce

With your OpenMage environment prepared, the next step is to install Craft Commerce. This installation process involves setting up the Craft CMS and configuring it to function as your new e-commerce platform.

Begin by ensuring your server meets Craft Commerce's system requirements, including:

  • PHP: Version 7.4 or later.
  • Database: MySQL 5.7 or later, or PostgreSQL 9.6 or later.
  • Web Server: Apache or Nginx.

Next, download the latest version of Craft Commerce from the Craft CMS official site. After downloading, extract the files to your desired directory on the server. You can use the following commands:

cd /path/to/your/webroot
unzip craft.zip

Once the files are extracted, navigate to your Craft Commerce installation in a web browser. You should be greeted with the installation wizard. Follow the prompts to set up your Craft Commerce instance:

  1. Enter your database connection details, including host, username, and password.
  2. Configure your site settings, such as your site's name and URL.
  3. Set up an admin account for managing your Craft Commerce store.

Upon successful installation, Craft Commerce will automatically generate a database schema tailored to its requirements. This process ensures that your new e-commerce platform is ready to receive data.

Step 3: Data Migration Planning

Data migration is one of the most critical components of the entire migration process from OpenMage to Craft Commerce. In this step, we will outline the essential elements of planning your data migration.

Start by identifying all data types in your OpenMage store that need to be migrated, including:

  • Products: Categories, attributes, and associated media.
  • Customers: All customer accounts, including their order history and preferences.
  • Orders: Historical order data and related transactions.
  • Content: Any CMS pages, blog posts, and other related content.

Next, map these data types to their corresponding structures in Craft Commerce. Craft provides a flexible structure for products, allowing for custom attributes and categories. This mapping process will help identify any gaps or required changes that need to be made during the migration.

Consider the following questions during your planning:

  • Are there any custom attributes in OpenMage that will need to be created in Craft Commerce?
  • How will product variants be handled in Craft Commerce?
  • What customer data needs to be anonymized or modified for compliance with regulations?

Once you have a clear mapping and plan in place, determine the tools you will use for the actual data migration. There are various options available, including:

  • Custom Scripts: Write scripts in PHP or another language to extract, transform, and load (ETL) data.
  • Third-Party Tools: Consider using migration tools like Migration Wizard or others that support OpenMage to Craft Commerce migrations.

By clearly defining your migration strategy, you will set the stage for a successful transition.

Step 4: Executing the Data Migration

With a solid plan in place, we can now proceed to execute the data migration from OpenMage to Craft Commerce. This phase involves the actual transfer of data based on the mapping and tools identified in the previous step.

Begin by performing a test migration using a subset of your data. This can help identify any issues that may arise during the full migration:

  • Export Data from OpenMage: Use your chosen method to export product, customer, order, and content data into a format compatible with Craft Commerce (e.g., CSV, JSON).
  • Transform Data: Modify the exported data as necessary to fit the structure and requirements of Craft Commerce. This may involve changing field names, formatting data types, or creating new fields for custom attributes.
  • Import Data into Craft Commerce: Use Craft's built-in import tools or custom scripts to import the transformed data into Craft Commerce. Be sure to validate the data after import to ensure accuracy.

Once the test migration is successful, proceed with the full migration of all data. It's advisable to schedule this migration during low-traffic periods to minimize disruption to your business operations.

After completing the full migration, conduct thorough testing to ensure all data has been transferred correctly. This includes:

  • Checking product listings for accuracy and completeness.
  • Verifying customer accounts and order histories.
  • Testing website functionality to ensure everything operates as expected.

Address any issues identified during testing before moving on to the next steps.

Step 5: Customizing Craft Commerce

With all data successfully migrated from OpenMage to Craft Commerce, the next step involves customizing your new platform to suit your business's branding and operational requirements.

Begin by exploring Craft Commerce's extensive customization options. You can modify the appearance and functionality of your store through:

  • Templates: Craft uses a flexible templating system that allows for extensive customization of the storefront. Adjust the layout, colors, and styles to align with your brand identity.
  • Plugins: Leverage Craft's plugin ecosystem to add additional functionalities to your store. Consider plugins for SEO, marketing, inventory management, and more.
  • Custom Fields: Define any custom fields that reflect the unique attributes of your products or services. This could include fields for dimensions, materials, or any other relevant information.

Next, configure your payment and shipping options within Craft Commerce. Ensure that the payment gateways you intend to use are properly set up and tested. Additionally, set your shipping methods, rates, and any geographical restrictions.

Finally, review and adjust your website's SEO settings. Craft Commerce offers several built-in SEO tools, allowing you to optimize your site for search engines effectively. Pay special attention to:

  • Meta tags for products and pages.
  • URL structures to ensure they are clean and SEO-friendly.
  • Redirects from old OpenMage URLs to new Craft Commerce URLs to maintain SEO rankings.

After completing these customizations, ensure to test the storefront thoroughly to confirm that all features work as intended and that branding is consistent.

Step 6: Final Testing and Quality Assurance

With Craft Commerce customized and configured, the next step is to conduct final testing and quality assurance. This phase is crucial for identifying any issues before launching your new store.

Start by testing all functionalities of your Craft Commerce store, including:

  • Product Browsing: Ensure that products are displayed correctly, including images, descriptions, and prices.
  • Checkout Process: Simulate purchases to test the entire checkout process, including payment and shipping options.
  • Customer Accounts: Verify that customers can create accounts, log in, and view their order history.
  • Mobile Responsiveness: Test the website on various devices and screen sizes to ensure a seamless shopping experience for all users.

Additionally, conduct performance testing to evaluate the speed and responsiveness of your new Craft Commerce site. Tools like Google PageSpeed Insights can provide valuable feedback on areas for improvement.

Finally, gather feedback from a select group of users (friends, family, or trusted customers) to identify any usability issues or areas for enhancement. This feedback can provide insights that may have been overlooked during the previous testing phases.

Step 7: Launching Your Craft Commerce Store

With thorough testing and quality assurance completed, your Craft Commerce store is now ready for launch. This step involves making your store live and ensuring that all systems are functioning as expected.

Before you officially launch, consider the following:

  • Final Data Backup: Create a final backup of your OpenMage site and the newly migrated Craft Commerce site. This backup will be essential should any issues arise post-launch.
  • Domain Configuration: Ensure that your domain points to the correct Craft Commerce installation. Update your DNS settings if necessary to reflect the new site.
  • SSL Certificate: Make sure that your store is secured with an SSL certificate to protect customer transactions and data.
  • Announce Your Launch: Use your marketing channels to announce the launch of your new Craft Commerce store. This could include email newsletters, social media posts, and blog updates.

Once the above tasks are completed, you can officially launch your Craft Commerce site. Monitor the site closely during the initial days post-launch to address any issues that may arise promptly.

Power Your Step - Get in Touch

Ready to make the switch from OpenMage to Craft Commerce? Our team of experts at PowerCommerce is here to assist you with every step of the migration process. We understand the complexities involved in transitioning to a new platform and are committed to making your migration as smooth as possible.

Contact us today to discuss your migration needs and leverage our extensive experience in e-commerce platform transitions:

  1. Visit our contact page to fill out our form.
  2. Call us directly at 800-099-9090.
  3. Email us at [email protected].

Let us help you power your e-commerce success with Craft Commerce!

Trusted by 1000+ innovative companies worldwide

Schedule Your Migration Today

For businesses prioritizing simplicity, scalability, and robust support, Shopify is the clear winner.

Looking to migrate without hassle? Power Commerce can handle the entire process, ensuring smooth data transfer, store setup, and post-launch success.


Marka Marulića 2, Sarajevo, 71000 BiH

[email protected]

Tell Us about yourself and we’ll get back to you shortly.

By submitting this form, you agree to Power Commerce's Terms of Service and Privacy Policy.