All articles
Platform Guide

Adobe Commerce Migration Guide for Agencies

Summary

Migrating off Adobe Commerce (Magento) is one of the most complex replatforming scenarios agencies face. This guide covers what to assess, what typically breaks, and how to scope these engagements accurately.

Adobe Commerce Migrations Are Archaeology Projects

Most Magento implementations have years of accumulated customization. Extensions installed and forgotten. Custom modules that bypass core functionality. Integrations held together with cron jobs and hope. Database tables that no one can explain.

The platform's flexibility, once its selling point, becomes the source of migration complexity. Every store is different. Every migration scope is wrong until you actually dig in.

Agencies that treat Adobe Commerce migrations like standard replatforms end up eating hours, missing deadlines, and damaging client relationships.

What to Look For in an Adobe Commerce Assessment

Extensions Hide More Than They Reveal

Start by cataloging every installed extension. Then determine:

  • Which are actively used vs. installed but disabled
  • Which have been modified from their original source
  • Which depend on other extensions
  • Which override core Magento functionality

Extensions that override core classes or use preference rewrites create hidden complexity. You won't find this in a feature list, you'll find it when something breaks post-migration.

Custom Modules Range From Trivial to Months of Rebuild

Assess:

  • How many custom modules exist
  • Whether they follow Magento coding standards
  • How tightly coupled they are to core functionality
  • Whether they contain business logic that must be replicated

Some custom modules are trivial. Others represent months of development that needs to be rebuilt or rearchitected on the target platform.

Data Migration Is Where Estimates Die

Adobe Commerce allows extensive database customization. Look for:

  • Custom EAV attributes (product, customer, category)
  • Custom tables and their relationships
  • Modified core tables
  • Data stored in serialized fields

The EAV structure means data is scattered across dozens of tables. Custom attributes multiply the complexity. This is where most estimates go wrong.

Integration Patterns Matter More Than Integration Counts

Map every integration point:

  • ERP connections (SAP, NetSuite, Dynamics)
  • PIM systems
  • OMS and fulfillment
  • Payment gateways (especially custom implementations)
  • Shipping and tax services
  • Marketing automation
  • Custom API consumers

Pay attention to how integrations are implemented. Direct database writes? Custom API endpoints? Message queues? Each pattern creates different migration requirements.

Frontend Architecture Varies Wildly

The frontend situation determines half your scope:

  • Luma theme with modifications
  • Fully custom theme
  • PWA Studio implementation
  • Headless with custom frontend

Headless implementations add a second codebase to assess. PWA Studio projects often have frontend logic that duplicates or extends backend functionality.

Performance "Features" That Won't Translate

Understand the current operational state:

  • Hosting setup (on-premise, Adobe Cloud, third-party)
  • Caching layers (Varnish, Redis, full-page cache rules)
  • Search implementation (Elasticsearch customizations, Live Search)
  • Performance optimizations and workarounds

Some "features" are actually performance hacks that won't translate to other platforms.

Patterns That Signal Scope Risk

Heavy Catalog Customization

Stores with complex product types, custom options, or heavily modified configurable product logic are high-risk. This functionality varies significantly across platforms.

B2B Functionality

Adobe Commerce B2B features (company accounts, requisition lists, negotiable quotes, shared catalogs) don't have direct equivalents everywhere. Each feature needs mapping to the target platform's approach.

Multi-Store Complexity

Multi-website, multi-store, multi-store-view setups with shared catalogs but different pricing, different currencies, or different tax rules create scoping challenges. The target platform's multi-store model may work differently.

Checkout Customization

Heavily modified checkout flows are common in Adobe Commerce. Custom shipping methods, payment integrations, order splitting logic, all of this needs documentation and rearchitecting.

Admin Customizations

Custom admin grids, forms, and workflows often represent significant operational dependencies. Users have built processes around these customizations.

What a Good Assessment Actually Covers

Technical Discovery

  • Codebase audit (modules, extensions, overrides)
  • Database schema analysis
  • Integration mapping
  • Performance baseline

Business Process Discovery

  • Order lifecycle and fulfillment workflows
  • Customer service operations
  • Merchandising processes
  • Reporting dependencies

Stakeholder Input

  • Which features are actually used
  • What pain points exist today
  • What capabilities are expected on the new platform
  • What would they change if they could

Platform Fit Analysis

  • Feature mapping to target platform
  • Gap analysis with resolution options
  • Integration approach on target platform
  • Data migration strategy

Risk Documentation

  • Functionality that cannot be replicated
  • Data that may not migrate cleanly
  • Integrations that need rebuilding
  • Timeline and budget risks

How DigitalStack Structures This

System inventory captures the full technical landscape, extensions, custom modules, integrations, in a connected data model rather than scattered spreadsheets.

Stakeholder surveys gather input from operations, merchandising, and customer service teams systematically. You find out what's actually used before you start scoping.

Objectives tracking connects business goals to technical decisions. When a client asks why something is in scope, you have the traceable answer.

Architecture documentation maps current state to target state with clear gap identification. Requirements connect to implementation decisions.

Output generation produces assessment deliverables from structured data. When scope changes, documents update.

The result: migration assessments that hold up against reality, and clients who understand what they're buying.

Next Step

If you're scoping Adobe Commerce migrations with spreadsheets and slides, you're creating risk. See how DigitalStack structures complex platform assessments, request a demo.

Read Next

DigitalStack

Run structured discovery engagements

One connected workspace for discovery, stakeholder surveys, architecture modeling, estimation, and reporting.