Implementation best practices

Last update: 2023-06-27
  • Created for:
  • Experienced

There are many ways to implement an Adobe Commerce project. The best practices provided in this section describe the way Adobe expects customers and partners to implement specific use cases. These recommendations are designed to help prevent common problems and potential issues related to site configuration and customization, deployment, operations, performance, and upgrades.

These best practices are organized by implementation phase so you can find the recommendations that apply to your use case.

Planning Requirements gathering, architectural design, catalog design, project scoping, account provisioning, user access, extension purchasing
Development Local and staging environment setup, troubleshooting, code management, sprint planning, sprint review, acceptance testing, and customer sign-off
Launch Final pre- and post-launch checklist reviews, production deployment, security configuration, service verification, and performance monitoring
Maintenance Site monitoring, catalog management, indexing, configuration, feature enhancements, bug fixing, managed services, upgrades

What’s new in implementation best practices

This page contains recent changes that we think you’d like to see. We exclude all minor updates, such as copy editing, from this list.

November 7, 2023

Description Type Source

Added a security best practices topic to the Implementation Playbook.

best-practices 2ffda8 (commit)

August 28, 2023

Description Type Source

Added the following new topics:
- Catalog image resizing best practices
- Code management best practices
- Code review best practices
- Debugging best practices
- Exception handling best practices
- General development best practices
- Git branching best practices
- Global reference architecture (GRA) examples
- Composer development for GRA
- Composer project structure for GRA
- Composer tips and tricks for GRA

best-practices fd708c (commit)

August 25, 2023

Description Type Source

Added a new topic about optimizing the backend performance of Adobe Commerce sites.

best-practices ecbb71 (commit)

August 23, 2023

Description Type Source

Consolidated all product-related best practices topics into a single catalog management topic and added relevant redirects.

best-practices ec5a69 (commit)

Added a new topic about implementing a centralized patching strategy for Adobe Commerce projects.

best-practices 03cb50 (commit)

On this page