Implementation guides
85 guides for teams that run SAP Commerce, down to the config, the query plan, and the failure mode.
Start with these
Composable Storefront
Composable Storefront SSR Incidents: Diagnose Timeouts, Hangs, and Memory Restarts
A production runbook for Composable Storefront SSR timeouts, hung renders, Node heap growth, cache failures, and safe remediation.
Advanced16 minJul 13, 2026
Upgrades and migration
SAP Commerce 2211 Upgrade Readiness Checklist
A practical readiness model for moving legacy Hybris and SAP Commerce landscapes onto 2211-jdk21, now that Commerce Cloud blocks Java 17 builds.
Advanced4 minSep 30, 2026
Performance
Performance Engineering for SAP Commerce: Targets, Load Models, and the Tuning Loop
SAP Commerce performance engineering: NFRs, PI/s, user journeys, volumetrics, CCv2 load tests, and a repeatable tuning cycle.
Advanced9 minJul 11, 2026
Upgrades and migration
From 6.x, 1905, or on-premise onto 2211-jdk21 on CCv2: the estimate, the tests, and the data move.
SAP Commerce 2211 Upgrade Readiness Checklist
A practical readiness model for moving legacy Hybris and SAP Commerce landscapes onto 2211-jdk21, now that Commerce Cloud blocks Java 17 builds.
Advanced
/ 4 min readUpgrading SAP Commerce from 6.x to 2211: The Stepping-Stone Walkthrough
A multi-version upgrade reference: the per-hop validation matrix, the recurring failure classes, the JDK and Spring jumps, and compressing the stepping stones.
Expert
/ 8 min readEstimating an SAP Commerce Upgrade: The Hands-On Assessment Method
Estimate SAP Commerce upgrades with git overlays, five evidence-based analysis phases, and practices that reduce the next upgrade.
Advanced
/ 8 min readMigrating to SAP Commerce Cloud: Assessment, Planning, and the Technical Gap List
Plan an on-premise SAP Commerce to CCv2 move: assessment, environment sequencing, and adaptations for SMTP, ImageMagick, and caches.
Advanced
/ 9 min readExecuting an SAP Commerce Upgrade: Testing, Deployment, and the First Two Weeks After
Execute SAP Commerce upgrades with reloadable test data, rehearsed deployment and rollback, regression coverage, and post-go-live support.
Advanced
/ 10 min readCCv2 Data and Media Migration: DB Sync, AzCopy, and Choosing Your Code Freeze
CCv2 data and media migration using SAP Commerce DB Sync, AzCopy, verification, rollback practice, and code-freeze planning.
Advanced
/ 10 min readTesting a CCv2 Migration: The Two Extra Test Dimensions That Decide Success
Why migrating to Commerce Cloud needs more than regression: the sequenced plan, data and media validation, integration re-validation, and production data.
Intermediate
/ 7 min readMigrating Legacy Promotions to the Promotion Engine Without Breaking Old Orders
Migrate legacy SAP Commerce promotions to rule-engine equivalents, with cart handling, order recalculation, and integrity checks.
Advanced
/ 8 min read
Composable Storefront
Spartacus in production: SSR, OCC contracts, runtime configuration on CCv2, and the move off Accelerator.
Composable Storefront SSR Incidents: Diagnose Timeouts, Hangs, and Memory Restarts
A production runbook for Composable Storefront SSR timeouts, hung renders, Node heap growth, cache failures, and safe remediation.
Advanced
/ 16 min readComposable Storefront Engineering: Production Practices for Angular, CMS, and SSR
Production practices for Composable Storefront code: CMS boundaries, facades, lifecycle ownership, SSR-safe APIs, rendering policy, and release gates.
Advanced
/ 15 min readComposable Storefront on CCv2: Build, Runtime Configuration, and OCC Connectivity
Deploy Composable Storefront on CCv2 with reproducible artifacts, runtime OCC configuration, CORS, private API access, and browser/SSR verification.
Advanced
/ 14 min readComposable Storefront OCC Contract Hardening
How to keep Spartacus and custom composable storefronts stable while SAP Commerce OCC endpoints evolve behind them.
Advanced
/ 4 min readComposable Storefront: How It Actually Works Under the Hood
Composable storefront foundations: CMS page composition, CmsConfig mapping, OCC product-page calls, SSR, and required team skills.
Intermediate
/ 7 min readMigrating an Accelerator Storefront to Composable: The Inventory-Driven Method
A practical migration method for CMS inventory, component gap analysis, API-first OCC development, and console-warning-led implementation.
Advanced
/ 9 min readUntangling a Legacy Accelerator Storefront: The Customization Archaeology Before Any Storefront Decision
The customization archaeology before any storefront decision: the pure-versus-customized diff, the layer-by-layer risk map, and the debt that decides the path.
Advanced
/ 14 min readStorefront Strategy After the Accelerator: Your Options and the Clock
Choose a post-Accelerator SAP Commerce storefront: composable, custom headless, or a managed transition while the OCC add-on removals approach.
Intermediate
/ 8 min readHeadless Commerce with SAP Commerce: Decoupling Without Losing Your Head
A working definition of headless for SAP Commerce: OCC as the seam, the many-headed reality, readiness over rewrites, and the auth, cache, and CMS traps.
Intermediate
/ 8 min readWeb Analytics on SAP Commerce: GA4, Tag Manager, and the DataLayer Done Right
Implement SAP Commerce GA4 with dataLayer architecture, journey events, consent integration, and revenue-data QA.
Intermediate
/ 9 min read
CCv2 and operations
Builds, deployments, networking, logs, Dynatrace, scaling, and go-live on SAP Commerce Cloud.
Your First SAP Commerce Cloud Build and Deployment, Done Right
First CCv2 build and deployment: repository and manifest setup, endpoint security, initial release, and Cloud Portal API automation.
Introductory
/ 9 min readThe Cloud Portal Operations Handbook: Environments, Builds, Backups, and Self-Service
Operating a CCv2 subscription: the three environments and sizing, the manifest-driven build, the ephemeral-storage rule, and backup versus disaster recovery.
Intermediate
/ 8 min readContinuous Delivery for SAP Commerce Cloud: Your Pipeline in Front of Theirs
CCv2 continuous delivery with fast and full builds, quality gates, Cloud Portal API automation, and controlled production deployment.
Advanced
/ 8 min readGo-Live Readiness for SAP Commerce Cloud: The Checks That Decide the Weekend
SAP Commerce go-live readiness: rehearsed deployment, type-system rollback, DNS and SEO cutover, user migration, and monitoring.
Intermediate
/ 8 min readLogging and Diagnostics on CCv2: From Ephemeral Nodes to Searchable Signal
Seeing what your solution does with ephemeral disks and no shell: centralized aggregation, log-level discipline, correlation IDs, and runtime diagnostics.
Intermediate
/ 8 min readDynatrace on SAP Commerce Cloud: The Troubleshooting Workflows That Matter
CCv2 Dynatrace workflows for slow sites, database hotspots, failing pages, exceptions, thread analysis, and retention limits.
Intermediate
/ 7 min readCCv2 Web and Network Architecture: Endpoints, CDN Integration, and VPN
What you can and cannot configure in the CCv2 web and network layers: endpoints, IP filters, certificates and mTLS, CDN and WAF integration, DNS, and VPN.
Intermediate
/ 8 min readInstance Strategy for SAP Commerce Cloud: One Global, Many Regional, or Something Between
The four instance strategies for global SAP Commerce estates, the factors that decide between them, and the honest costs of running multiple instances.
Advanced
/ 8 min readCCv2 Aspects, Clustering, and Scaling: Designing Inside a Fixed Footprint
How the CCv2 cluster is shaped: the aspect model, why backgroundProcessing has a fixed budget, writing bulk jobs that respect it, and horizontal scaling.
Advanced
/ 8 min readWeb Sessions on CCv2: Sticky Routing, Cart Binding, Cookies, and the Headless Shift
How sessions behave on CCv2: HTTP versus Jalo sessions, sticky routing, cart binding and merge-on-login, cookie security, timeouts, and the headless shift.
Advanced
/ 8 min readOn-Premise SAP Commerce Infrastructure: The Complete Hardening and Tuning Guide
For self-hosted estates: cluster topology, load balancer stickiness traps, Apache tuning, current JVM and G1 settings, database rules, and hardening.
Expert
/ 10 min read
Performance
Caching, locking, promotions, media, and peak traffic, measured before and after.
Performance Engineering for SAP Commerce: Targets, Load Models, and the Tuning Loop
SAP Commerce performance engineering: NFRs, PI/s, user journeys, volumetrics, CCv2 load tests, and a repeatable tuning cycle.
Advanced
/ 9 min readPreparing SAP Commerce Cloud for High-Traffic Events
SAP Commerce peak-event readiness with Dynatrace baselines, SAP lead time, controlled releases, cronjob freezes, and promotion hygiene.
Intermediate
/ 9 min readPersistence and Caching in SAP Commerce: Region Caches, the Type Cache, and CCv2 Sizing
The cache hierarchy that serves most requests: entity and query regions, cluster invalidation, heap-relative sizing with SpEL, and the measurement loop.
Advanced
/ 7 min readPromotion Engine Performance: Ten Fixes for a Slow Drools Rule Base
Promotion Engine performance: rule base statistics, discount rows, virtual categories, KIE splits, expired-rule cleanup, and fewer evaluations.
Advanced
/ 9 min readTransactions and Locking in SAP Commerce: Keeping Them Short, Correct, and Deadlock-Free
The transaction discipline behind a checkout that holds: short transactions, no remote calls inside them, optimistic-locking retries, deadlock avoidance.
Expert
/ 7 min readMedia Management in SAP Commerce: Storage, Conversion, Secure Access, and the CDN
How media works: the Media and MediaContainer model, cloud format conversion, secure access, why ephemeral storage means cloud storage, and CDN delivery.
Intermediate
/ 7 min readNon-Functional Requirements for Commerce: The ISO 25010 Catalog That Prevents Scope Fights
The NFRs that decide production-readiness, organized by ISO 25010: capacity and time behavior with real numbers, testable definitions, and out-of-scope.
Intermediate
/ 9 min read
Integrations
OData, the Integration API, webhooks, Kyma events, hot folders, and email, with the failure paths.
Integration Options for SAP Commerce Cloud: Choosing the Right Channel in 2026
SAP Commerce 2211 integration choices: Integration APIs, OData, webhooks, OutboundSync, Integration Suite, Kyma, Hot Folders, and ImpEx.
Intermediate
/ 10 min readIntegration Objects and OData: The Hands-On Guide to Commerce Integration APIs
Modeling Integration Objects that hold up: item and attribute definitions, inbound OAuth channels, virtual and runtime attributes, the MetaAPI, and monitoring.
Advanced
/ 7 min readWebhooks at Scale: Commerce Event Notifications That Survive Production Traffic
Webhook integrations that survive production traffic: the ack-fast-queue-later consumer, signature verification, dedupe, ordering, and reconciliation.
Advanced
/ 7 min readIntegration Monitoring and Alerting: Nobody Watches Dashboards at 3 a.m.
Turning integration monitoring into alerts someone receives: the four signal sources, the freshness principle, a timer-driven alert flow, and alert design.
Intermediate
/ 7 min readCustom Events and Side-by-Side Extensions: Commerce to BTP Kyma End to End
An event-driven SAP Commerce pattern: define a custom event, export it to Kyma, and call back through Integration API and OCC.
Expert
/ 8 min readSide-by-Side Extensibility: Deciding What Leaves the Platform, and Building It
The decision framework for in-platform versus side-by-side extensions, the integration seams that make external apps safe, and low-code with real governance.
Intermediate
/ 7 min readLocal Kyma Development for Commerce Extensions: Mocks, Wiring, and the Fast Loop
Building commerce extensions without shared environments: a local Kyma cluster, the commerce mock, the certificate and DNS wiring, and where the tooling moved.
Advanced
/ 7 min readCloud Hot Folders: Migration, Configuration, and Troubleshooting
Cloud Hot Folders with Azure Blob, legacy Spring migration, external imports, local Azurite testing, and failure diagnosis.
Advanced
/ 9 min readTransactional Email on SAP Commerce Cloud: Providers, Protocols, and Deliverability
CCv2 transactional email with SMTP or REST APIs, EmailSendStrategy, SPF/DKIM/DMARC, bounce handling, and delivery testing.
Intermediate
/ 8 min readAmazon SES for SAP Commerce Email: Setup, Deliverability, and Closing the Bounce Loop
Running Amazon SES behind SAP Commerce: the IAM, SNS, and SQS wiring, the SPF/DKIM/DMARC trinity, bounce handling, and testing with the mailbox simulator.
Intermediate
/ 11 min read
Search
Solr indexing, relevance tuning, scaling, and the search settings business users own.
Solr Search in SAP Commerce: Architecture and Indexing Done Right
SAP Commerce search indexing: indexed types, full and partial runs, two-phase commits, value providers, and safe scheduling.
Advanced
/ 9 min readSolr Query Tuning and Troubleshooting in SAP Commerce
Tune SAP Commerce Solr queries, boosts, and query builders; use the admin console to diagnose stale data, facets, 404s, and scores.
Advanced
/ 10 min readSolr Infrastructure for SAP Commerce: Topology, Sizing, and Tuning
Solr Cloud and standalone architecture: ZooKeeper quorum, shards, replicas, JVM sizing, solrconfig tuning, and CCv2 boundaries.
Advanced
/ 9 min readSearch Merchandising in SAP Commerce: The Business-User Levers on Solr
The search levers a merchandiser owns without code: indexed attributes and weighting, the search bar, stopwords and synonyms, redirects, and Adaptive Search.
Intermediate
/ 9 min read
Data and catalog
ImpEx, catalog sync, the type system, content catalogs, and data retention.
ImpEx: The Working Reference for People Who Load Data for a Living
Header modes and modifiers, macros and config-driven scripts, document IDs, media and user rights, the resolver and dump files, and distributed ImpEx.
Intermediate
/ 8 min readData Loading Strategies: Essential, Sample, and Production Data Without Conflicts
SAP Commerce data loading with AutoImpEx conventions, environment-specific imports, release data, anonymization, and migration paths.
Intermediate
/ 10 min readCatalog Synchronization: How It Works and How to Make It Fast
SAP Commerce catalog sync triggers, filtering, merge semantics, failure diagnosis, and production tuning for reliable synchronization.
Advanced
/ 14 min readData Modeling with the SAP Commerce Type System: Decisions That Age Well
Design durable SAP Commerce items.xml changes: extension or subtype, deployment tables, typecodes, relations, dynamic attributes, and debt.
Intermediate
/ 9 min readContent Catalog Design: Single, Shared, and Multi-Layered Strategies
WCMS content catalog topology for multi-site SAP Commerce: reuse, restrictions, country layering, and SmartEdit approvals.
Intermediate
/ 7 min readData Maintenance and Cleanup: Retention Rules That Keep Commerce Fast
SAP Commerce cleanup for audit data, cronjobs, ImpEx media, sessions, business processes, carts, purges, and sanecleanup.
Intermediate
/ 11 min read
Development
FlexibleSearch, the service layer, code review, testing, cronjobs, HAC, and a working local setup.
FlexibleSearch Mastery: From Syntax to Query Plans
The query language every developer writes daily: type-aware joins, localized attributes, session context, the query cache contract, and slow-query tuning.
Advanced
/ 7 min readService Layer Patterns in SAP Commerce: Services, Facades, Converters, and Interceptors Done Right
The patterns that keep custom code maintainable: service-and-facade layering, converters and populators, interceptors versus events, and injectable design.
Advanced
/ 8 min readThe SAP Commerce Code Review Playbook: Process and Checklist
A SAP Commerce code review system for pull requests, automation, models, interceptors, FlexibleSearch, cronjobs, sessions, and Backoffice.
Intermediate
/ 12 min readCoding Standards and Automated Quality Gates for SAP Commerce
SAP Commerce naming, layering, null and exception discipline, plus SonarQube quality profiles and sonarcheck enforcement.
Intermediate
/ 9 min readA Testing Strategy for SAP Commerce: The Pyramid, the Platform Specifics, and the Gates
Testing so quality is built in, not inspected: the pyramid applied to the platform, ImpEx fixtures, the CCv2 pipeline gates, and non-functional testing.
Intermediate
/ 9 min readCronJobs Done Right: Authoring, Scheduling, and Surviving the Cloud
The full lifecycle of background work: JobPerformable anatomy, triggers, node groups and aspects, abortable resumable jobs, log retention, and monitoring.
Intermediate
/ 7 min readThe hAC Power User Guide: Consoles, Diagnostics, and the Tricks Support Uses
The Hybris Administration Console beyond the basics: the consoles, cache and cluster diagnostics, live log levels, JDBC logging, and the tricks support uses.
Intermediate
/ 8 min readLocal Development Environment for SAP Commerce Cloud: Full CCv2 Parity
A CCv2-aligned local SAP Commerce setup with SQL Server in Docker, the correct JDK, manifest reuse, and cloud constraints.
Introductory
/ 10 min read
Security and identity
Hardening, GDPR, SSO with SAML and OIDC, B2B identity, 2FA, and user rights.
Security Hardening for SAP Commerce: The Application-Layer Checklist Pen Testers Start With
The security work that stays yours on CCv2: password encoding and TAE keys, the init lock, cockpit access, CORS and cookies, secure media, and the OWASP list.
Advanced
/ 7 min readData Protection in SAP Commerce: Consent, Erasure, Encryption, and Anonymization
SAP Commerce GDPR engineering: consent, erasure and reporting, attribute encryption, anonymization, and authentication hardening.
Advanced
/ 9 min readSAML SSO for SAP Commerce: Storefront, Backoffice, and the Flows Between
Federation without the folklore: SP versus IdP-initiated login, mapping assertions to customers and employees, the RelayState and domain traps, SAML or OIDC.
Advanced
/ 7 min readOIDC Login for Commerce Storefronts: Tokens, Flows, and the Commerce Session Bridge
OIDC as the storefront auth backbone: the authorization code flow with PKCE, the three tokens, the commerce session bridge, cart merge, and logout semantics.
Advanced
/ 11 min readB2B Identity for Commerce: Delegated Administration, BYOI, and Just-in-Time Provisioning
Why B2B login is an org problem: onboarding orgs versus users, delegated administration, login identifiers, bring-your-own-identity, JIT provisioning, and PBAC.
Advanced
/ 9 min readStorefront 2FA and Session Security: Risk-Based Auth in a Post-Third-Party-Cookie World
Securing logins without strangling conversion: the two-factor ladder, risk-based triggers, credential stuffing defense, and SSO after third-party cookies died.
Intermediate
/ 7 min readUser and Rights Management in SAP Commerce: Groups, Inheritance, and the Deny Trap
The Backoffice access model projects postpone and regret: groups and inheritance, type and attribute permissions, the standard groups, and the deny trap.
Intermediate
/ 9 min read
Architecture and strategy
Platform decisions: multi-site, marketplace, omnichannel, pricing, personalization, markets, and team shape.
SAP Commerce Cloud Architecture Overview
SAP Commerce Cloud architecture: platform services, CCv2 aspects, deployment pipelines, cluster topology, and integration patterns.
Intermediate
/ 12 min readWriting a Solution Architecture Definition for SAP Commerce: The Views That Actually Communicate
Documenting a commerce architecture without a doorstop: the multi-view structure, the reference-not-repeat discipline, and mapping decisions to the NFRs.
Intermediate
/ 8 min readMulti-Site and Multi-Storefront Architecture on SAP Commerce Cloud
Multi-site SAP Commerce architecture with BaseSite, BaseStore, catalogs, storefront resolution, CCv2 apps, webroots, cookies, and DNS.
Advanced
/ 7 min readRunning a Marketplace on SAP Commerce: Vendors, Suborders, and Controlling an Experience You Do Not Own
The architecture and operating model for a marketplace: the vendor portal, content governance, order splitting into suborders, and the support triangle.
Advanced
/ 8 min readOmnichannel Architecture on SAP Commerce: From Strategy Slide to Working System
Turning omnichannel ambition into SAP Commerce mechanics: the data domains that must unify first, cross-channel services, customer identity, and ASM.
Intermediate
/ 7 min readInventory Models and Availability in SAP Commerce: Deposit, Dropship, Consignment, Cross-Dock
How the inventory model becomes sourcing logic and stock feeds: deposit, dropship, consignment, and cross-dock, the multi-model reality, and platform mechanics.
Intermediate
/ 9 min readStore-Specific Pricing: From Variant Workaround to Price Engine Customization
Store-specific SAP Commerce pricing with variant products or custom price-engine work across storefront context, OCC, PDTRow, and Solr.
Expert
/ 9 min readPersonalization in SAP Commerce: Customizations, Segments, and Who Decides What a Shopper Sees
The native personalization module explained: customizations, variations, and triggers, segment providers, SmartEdit, the cache cost, and rule-based versus AI.
Advanced
/ 8 min readProduct Recommendations for SAP Commerce: Scenarios, Algorithms, and Making Them Earn Their Placement
Recommendations as a measured program: mapping scenarios to the buyer journey, the algorithm families, data quality, Intelligent Selling Services, and caching.
Intermediate
/ 10 min readThe Unified Customer Profile: Architecture for Knowing Who Your Customer Actually Is
Why the 360-degree customer view is a data-architecture decision: the silo problem, a governed profile at the center, consent, and online-to-offline identity.
Intermediate
/ 9 min readB2B Commerce Adoption: Why Buyers Ignore the Portal You Built, and How to Fix It
The three differences that make B2B digital hard (committee buying, job-performance stakes, layered security) and the commerce capabilities that clear each.
Introductory
/ 7 min readInternationalization in SAP Commerce: Global Versus Local, Decided Per Concern
SAP Commerce internationalization for catalogs, content, pricing, taxes, payments, fulfilment, search, and country architecture.
Advanced
/ 10 min readSAP Commerce for the Chinese Market: A Different Project, Not a Different Locale
Why China is an architecture decision, not a locale: data residency, ICP filing, marketplace strategy, WeChat, Alipay and WeChat Pay, and Baidu SEO.
Advanced
/ 9 min readStaffing a SAP Commerce Project: The Roles You Need and When You Need Them
Who has to be on a commerce delivery team: oversight, day-to-day and SME roles, the business representative who decides, and how team shape shifts by phase.
Introductory
/ 7 min read