Guidelines
13-Jul-2026 • 48G418 • Table Of Contents Introduction New Libraries Library Updates Removed Libraries Introduction This guide provides information about the update of several libraries. The following tables contain differences between: Old - ICM 7.10.41.18 - Responsive (35.3.18) New - ICM 7.10.41.19 - Responsive (35.4.0)
References
09-Jul-2026 • 4841C7 • This API specification is available for download as an Open API 3.0 YAML file: icm-b2b-basket-1x3x5.yaml References To learn more about Intershop’s REST API approach and framework, refer to: Concept - REST Framework The following page lists available REST APIs for ICM 7.10 and their version dependencies:
Guidelines
15-Jun-2026 • 48L416 • Table Of Contents Introduction REST API Changes Process Changes Introduction The Rating & Review REST API provides methods for retrieving product-specific ratings and reviews for both anonymous and authenticated users. In both cases, the result lists were cached, leading to problems with “own” reviews
Guidelines
12-Jul-2026 • 48413H • Table Of Contents Declare Components in the Right NgModule Do not use NgRx or Services in Components Delegate Complex Component Logic to Services Put as Little Logic Into constructor as Possible - Use ngOnInit Use Property Binding to Bind Dynamic Values to Attributes or Properties Do Not Unsubscribe
Concepts
12-Jul-2026 • 4841B2 • Table Of Contents Server-Side Rendering robots.txt Page Metadata Optimized URLs This concept documents our approach for search engine optimization for the Intershop Progressive Web App. Server-Side Rendering The PWA uses SSR for pre-rendering complete pages to tackle SEO concerns. An Angular application
Guidelines
12-Jul-2026 • E48411 • The data models for server-side and client-side have to be separated, because the data sent by the server may change over iterations or may not be in the right format, while the client side shop data handling should be stable for a long time. Therefore, each service communicating with the Intershop REST
Guidelines
12-Jul-2026 • 48410L • Table Of Contents Introduction Configuration Login Token Lifetime Logout Important To use the Co-Browse functionality ICM version 11.8.0 or above is needed. This document describes the authentication mechanism if the co-browse identity provider is used to enable an agent to log in on behalf of a user
Guidelines
12-Jul-2026 • 484Y09 • Table Of Contents Introduction UX Patterns Navigation Patterns Skip Links for Long Listings Form Patterns Focus Management on Validation Errors Avoid Disabled Buttons Password Autocomplete Component Behavior Links with Icons Do Not Require Underlines Popovers Open on Click Instead of Hover Summary Introduction
Guidelines
12-Jul-2026 • 4840V8 • Table Of Contents Zones Zone Stability Using Zone Stability Service Workers and SSR Pitfall: The Zone Must Become Stable Change detection is one of the core concepts of Angular. Component templates contain data bindings that embed data from the component class into the view. The change detection cycle
Concepts
12-Jul-2026 • 48407N • This concept introduces some decisions made from an architectural point of view. The Intershop Progressive Web App is a REST API based storefront client that works together with the Intershop Commerce Management server version 11 or 7.10. This means that the communication between the Angular based storefront
Guidelines
12-Jul-2026 • 484Y06 • Table Of Contents Code Integrity Dependencies Code Formatting Unit Testing UI Testing Lighthouse Testing Performance Checks Accessibility Checks Testing Server-Side Rendering Static Code Analysis This section provides an overview of required continuous integration steps to verify the validity of code
Concepts
12-Jul-2026 • 4Q8405 • Table Of Contents Web App Manifest Service Worker In order to be a Progressive Web Application, the Intershop PWA implements some advanced concepts matching those criteria. Web App Manifest The Web App Manifest enables the PWA to be installable on home screens of mobile devices. The application is easily
Concepts
12-Jul-2026 • 48404H • Table Of Contents File Name Conventions General Folder Structure Extension Folder Structure Modules Extending Modules File Name Conventions In accordance with the Angular Style Guide and the Angular CLI convention of naming generated elements in the file system, all file and folder names should use a
Concepts
12-Jul-2026 • 48C403 • Table Of Contents Simple Browser-Side Rendering Browser-Side Rendering with On-Demand Server-Side Pre-Rendering (Angular SSR) Impact of Service Workers Further References Simple Browser-Side Rendering Angular applications are built for a static deployment by default. When running npm run build in any
Guidelines
12-Jul-2026 • 484V02 • Table Of Contents Configuration Login Registration Token Lifetime Logout This document describes the authentication mechanism if punchout is used as identity provider. If you need an introduction to this topic, read the Authentication Concept first. Configuration The PWA must be configured in a specific
Guidelines
12-Jul-2026 • 48401L • Table Of Contents Syntax Examples One Domain, One Channel, Multiple Locales Multiple Domains, Multiple Channels, Multiple Locales Multiple Subdomains, Multiple Channels, Multiple Locales Extended Example with Many Different Configurations Extended Example with Two Domains, One with Basic Auth (Except
Guidelines
12-Jul-2026 • 4840N0 • Table Of Contents Apple App Site Association Configuring the PWA to Serve the AASA File Further References The /.well-known/ directory is a standardized location defined by RFC 8615. It is used to host configuration files and metadata that allow external services (such as mobile app linking, authentication
Concepts
12-Jul-2026 • H48399 • Table Of Contents Motivation Configuration Multi-Site Production Deployment Further References Motivation Imagine running an Europe-wide shop with Intershop, where the website is available in 16 different countries with different languages and a varying selection of products, but only little modification
Guidelines
10-Jul-2026 • 48398C • Table Of Contents Login Registration Token Lifetime Logout This document describes the main authentication mechanism if the ICM server is used as identity provider. If you need an introduction to this topic, read the Authentication Concept first. Login If the user wants to login by clicking a login link
Concepts
10-Jul-2026 • 483C97 • Table Of Contents Architecture State Selectors Actions Reducers Effects Facades Context Facades File Structure Core Store Structure Naming Actions - Types Actions - Creators Reducer State Selectors Facades - Streams Facades - Action Dispatchers Entity State Adapter for Managing Record Collections: @ngrx/entity