# Shopware ADRs (index)

Architecture Decision Records mirrored from the Shopware 6 repository. **Full text:** use the official link per row (this file is an index to save bundle size).

| Topic | Title | Official |
| --- | --- | --- |
| 2020-06-25-implement-architecture-decision-records.md | Implement architecture decision records | [resources/references/adr/2020-06-25-implement-architecture-decision-records.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-06-25-implement-architecture-decision-records.md) |
| 2020-07-02-control-clone-behavior.md | Get control of association clone behavior as developer | [resources/references/adr/2020-07-02-control-clone-behavior.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-07-02-control-clone-behavior.md) |
| 2020-07-02-implement-sales-channel-context-token-requirement.md | Implement sales channel context token requirement for store-api and sales-channel-api | [resources/references/adr/2020-07-02-implement-sales-channel-context-token-requirement.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-07-02-implement-sales-channel-context-token-requirement.md) |
| 2020-08-03-implement-new-changelog.md | Implement new changelog | [resources/references/adr/2020-08-03-implement-new-changelog.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-08-03-implement-new-changelog.md) |
| 2020-08-10-feature-flag-system.md | Feature flag system | [resources/references/adr/2020-08-10-feature-flag-system.md](https://developer.shopware.com/docs/v6.5/resources/references/adr/2020-08-10-feature-flag-system.md) |
| 2020-08-12-document-template-refactoring.md | Document template refactoring | [resources/references/adr/2020-08-12-document-template-refactoring.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-08-12-document-template-refactoring.md) |
| 2020-08-12-implement-app-system-inside-platform.md | Implement app system inside platform | [resources/references/adr/2020-08-12-implement-app-system-inside-platform.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-08-12-implement-app-system-inside-platform.md) |
| 2020-08-14-implement-individual-sorting.md | Implement individual sorting | [resources/references/adr/2020-08-14-implement-individual-sorting.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-08-14-implement-individual-sorting.md) |
| 2020-08-14-merchant-registration.md | Merchant registration | [resources/references/adr/2020-08-14-merchant-registration.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-08-14-merchant-registration.md) |
| 2020-08-19-handling-feature-flags.md | Handling feature flags | [resources/references/adr/2020-08-19-handling-feature-flags.md](https://developer.shopware.com/docs/v6.5/resources/references/adr/2020-08-19-handling-feature-flags.md) |
| 2020-08-21-unified-notification-titles.md | Notification titles are pre-defined and make use of the global namespace | [resources/references/adr/2020-08-21-unified-notification-titles.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-08-21-unified-notification-titles.md) |
| 2020-08-28-import-acl-privileges-from-other-roles.md | Import ACL privileges from other roles | [resources/references/adr/2020-08-28-import-acl-privileges-from-other-roles.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-08-28-import-acl-privileges-from-other-roles.md) |
| 2020-09-08-custom-field-label-loading-in-storefront.md | CustomField label loading in storefront | [resources/references/adr/2020-09-08-custom-field-label-loading-in-storefront.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-09-08-custom-field-label-loading-in-storefront.md) |
| 2020-09-17-the-best-practice-to-always-re-fetch-the-data-after-saving.md | The best-practice to always re-fetch the data after saving | [resources/references/adr/2020-09-17-the-best-practice-to-always-re-fetch-the-data-after-saving.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-09-17-the-best-practice-to-always-re-fetch-the-data-after-saving.md) |
| 2020-11-06-creating-events.md | Creating events in Shopware | [resources/references/adr/2020-11-06-creating-events.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-11-06-creating-events.md) |
| 2020-11-19-dal-join-filter.md | DAL join filter | [resources/references/adr/2020-11-19-dal-join-filter.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-11-19-dal-join-filter.md) |
| 2020-11-20-add-login-required-annotation.md | Add the login required annotation | [resources/references/adr/2020-11-20-add-login-required-annotation.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-11-20-add-login-required-annotation.md) |
| 2020-11-25-decoration-pattern.md | Decoration pattern | [resources/references/adr/2020-11-25-decoration-pattern.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-11-25-decoration-pattern.md) |
| 2020-12-02-removing-api-version.md | API version removal | [resources/references/adr/2020-12-02-removing-api-version.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2020-12-02-removing-api-version.md) |
| 2021-01-21-deprecation-strategy.md | Deprecation strategy | [resources/references/adr/2021-01-21-deprecation-strategy.md](https://developer.shopware.com/docs/v6.5/resources/references/adr/2021-01-21-deprecation-strategy.md) |
| 2021-03-24-nested-line-items.md | Processing of nested line items | [resources/references/adr/2021-03-24-nested-line-items.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-03-24-nested-line-items.md) |
| 2021-05-14-when-to-use-plain-sql-or-dal.md | When to use plain SQL or the DAL | [resources/references/adr/2021-05-14-when-to-use-plain-sql-or-dal.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-05-14-when-to-use-plain-sql-or-dal.md) |
| 2021-05-28-introduce-eslint-on-vue-admin.md | Vue administration app has ESLint support | [resources/references/adr/2021-05-28-introduce-eslint-on-vue-admin.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-05-28-introduce-eslint-on-vue-admin.md) |
| 2021-06-14-introduce-jest-fail-on-console.md | Introduce jest-fail-on-console | [resources/references/adr/2021-06-14-introduce-jest-fail-on-console.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-06-14-introduce-jest-fail-on-console.md) |
| 2021-07-22-move-storefront-scripts-to-head.md | Move storefront script to head with defer | [resources/references/adr/2021-07-22-move-storefront-scripts-to-head.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-07-22-move-storefront-scripts-to-head.md) |
| 2021-08-10-storefront-coding-standards.md | Storefront coding standards | [resources/references/adr/2021-08-10-storefront-coding-standards.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-08-10-storefront-coding-standards.md) |
| 2021-08-11-make-platform-stand-alone.md | Make shopware/shopware stand-alone for development and testing | [resources/references/adr/2021-08-11-make-platform-stand-alone.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-08-11-make-platform-stand-alone.md) |
| 2021-08-31-refactor-admin-build-process-to-webpack-multi-compiler-mode.md | Refactor admin build process to webpack-multi-compiler mode | [resources/references/adr/2021-08-31-refactor-admin-build-process-to-webpack-multi-compiler-mode.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-08-31-refactor-admin-build-process-to-webpack-multi-compiler-mode.md) |
| 2021-09-06-make-core-mail-templates-independent-from-storefront-urls.md | Make Core mail templates independent from Storefront urls | [resources/references/adr/2021-09-06-make-core-mail-templates-independent-from-storefront-urls.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-09-06-make-core-mail-templates-independent-from-storefront-urls.md) |
| 2021-09-14-technical-concept-custom-entities.md | Technical concept custom entities | [resources/references/adr/2021-09-14-technical-concept-custom-entities.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-09-14-technical-concept-custom-entities.md) |
| 2021-09-22-refactor-theme-inheritance.md | Refactor theme inheritance | [resources/references/adr/2021-09-22-refactor-theme-inheritance.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-09-22-refactor-theme-inheritance.md) |
| 2021-10-01-payment-flow.md | Payment Flow | [resources/references/adr/2021-10-01-payment-flow.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-10-01-payment-flow.md) |
| 2021-10-13-refund-handling.md | Refund handling | [resources/references/adr/2021-10-13-refund-handling.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-10-13-refund-handling.md) |
| 2021-10-21-app-scripting.md | App scripts | [resources/references/adr/2021-10-21-app-scripting.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-10-21-app-scripting.md) |
| 2021-11-02-preparing-data-for-rule-evaluation.md | Preparing data for rule evaluation | [resources/references/adr/2021-11-02-preparing-data-for-rule-evaluation.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-11-02-preparing-data-for-rule-evaluation.md) |
| 2021-11-05-adjust-adr-approval-rules.md | Adjust ADR approval rules for the new org structure | [resources/references/adr/2021-11-05-adjust-adr-approval-rules.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-11-05-adjust-adr-approval-rules.md) |
| 2021-11-09-increment-pattern.md | Introduce increment pattern | [resources/references/adr/2021-11-09-increment-pattern.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-11-09-increment-pattern.md) |
| 2021-11-22-merge-e2e-projects-into-a-single-project.md | Merge E2E projects into a single project | [resources/references/adr/2021-11-22-merge-e2e-projects-into-a-single-project.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-11-22-merge-e2e-projects-into-a-single-project.md) |
| 2021-11-23-add-possibility-for-plugin-to-add-a-html-file.md | Add possibility for plugins to add a HTML file | [resources/references/adr/2021-11-23-add-possibility-for-plugin-to-add-a-html-file.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-11-23-add-possibility-for-plugin-to-add-a-html-file.md) |
| 2021-12-07-admin-extension-api-standards.md | Admin extension API standards | [resources/references/adr/2021-12-07-admin-extension-api-standards.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2021-12-07-admin-extension-api-standards.md) |
| 2022-01-05-add-feature-flag-support-for-storefront-scss.md | Add feature flag support for Storefront SCSS | [resources/references/adr/2022-01-05-add-feature-flag-support-for-storefront-scss.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-01-05-add-feature-flag-support-for-storefront-scss.md) |
| 2022-01-06-custom-app-api-endpoints.md | Allow apps to define custom api endpoints | [resources/references/adr/2022-01-06-custom-app-api-endpoints.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-01-06-custom-app-api-endpoints.md) |
| 2022-01-20-feature-flags-for-major-versions.md | Feature flags for major versions | [resources/references/adr/2022-01-20-feature-flags-for-major-versions.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-01-20-feature-flags-for-major-versions.md) |
| 2022-02-09-controller-configuration-route-defaults.md | Move controller level annotation into Symfony route annotation | [resources/references/adr/2022-02-09-controller-configuration-route-defaults.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-02-09-controller-configuration-route-defaults.md) |
| 2022-02-21-rule-scripting-in-apps.md | Rule Scripting in apps | [resources/references/adr/2022-02-21-rule-scripting-in-apps.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-02-21-rule-scripting-in-apps.md) |
| 2022-02-24-domain-exceptions.md | Domain exceptions | [resources/references/adr/2022-02-24-domain-exceptions.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-02-24-domain-exceptions.md) |
| 2022-02-28-consistent-deprecation-notices-in-core.md | Consistent deprecation notices in Core | [resources/references/adr/2022-02-28-consistent-deprecation-notices-in-core.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-02-28-consistent-deprecation-notices-in-core.md) |
| 2022-03-09-reset-class-state-during-requests.md | Use `ResetInterface` to reset instance state during requests | [resources/references/adr/2022-03-09-reset-class-state-during-requests.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-09-reset-class-state-during-requests.md) |
| 2022-03-15-extract-data-handling-classes-to-extension-sdk.md | Extract data handling classes to extension sdk | [resources/references/adr/2022-03-15-extract-data-handling-classes-to-extension-sdk.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-15-extract-data-handling-classes-to-extension-sdk.md) |
| 2022-03-17-new-nested-line-items.md | New templates for line items and nested line items | [resources/references/adr/2022-03-17-new-nested-line-items.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-17-new-nested-line-items.md) |
| 2022-03-25-available-stock.md | Available stock improvements | [resources/references/adr/2022-03-25-available-stock.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-25-available-stock.md) |
| 2022-03-25-base-context-factory.md | Base context factory | [resources/references/adr/2022-03-25-base-context-factory.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-25-base-context-factory.md) |
| 2022-03-25-cache-stampede-protection.md | Cache stampede protection | [resources/references/adr/2022-03-25-cache-stampede-protection.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-25-cache-stampede-protection.md) |
| 2022-03-25-initial-state-id-loader.md | Initial state id loader | [resources/references/adr/2022-03-25-initial-state-id-loader.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-25-initial-state-id-loader.md) |
| 2022-03-25-prevent-mail-updates.md | Prevent mail updates | [resources/references/adr/2022-03-25-prevent-mail-updates.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-25-prevent-mail-updates.md) |
| 2022-03-25-profiler-integrations.md | Profiler integrations | [resources/references/adr/2022-03-25-profiler-integrations.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-25-profiler-integrations.md) |
| 2022-03-25-redis-cart-persister.md | Redis cart persister | [resources/references/adr/2022-03-25-redis-cart-persister.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-25-redis-cart-persister.md) |
| 2022-03-29-specify-priority-of-translations-in-dal-write-payloads.md | Specify priority of translations in DAL write payloads | [resources/references/adr/2022-03-29-specify-priority-of-translations-in-dal-write-payloads.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-03-29-specify-priority-of-translations-in-dal-write-payloads.md) |
| 2022-04-06-add-default-cms-layouts-to-products-and-categories.md | Add default cms pages to products and categories | [resources/references/adr/2022-04-06-add-default-cms-layouts-to-products-and-categories.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-04-06-add-default-cms-layouts-to-products-and-categories.md) |
| 2022-04-19-integrate-app-into-flow-action.md | Integrate an app into flow action | [resources/references/adr/2022-04-19-integrate-app-into-flow-action.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-04-19-integrate-app-into-flow-action.md) |
| 2022-04-28-tax-providers.md | Introducing tax providers | [resources/references/adr/2022-04-28-tax-providers.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-04-28-tax-providers.md) |
| 2022-05-12-remove-static-analysis-with-psalm.md | Remove static analysis with psalm | [resources/references/adr/2022-05-12-remove-static-analysis-with-psalm.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-05-12-remove-static-analysis-with-psalm.md) |
| 2022-05-23-rule-condition-field-abstraction.md | Rule condition field abstraction | [resources/references/adr/2022-05-23-rule-condition-field-abstraction.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-05-23-rule-condition-field-abstraction.md) |
| 2022-06-17-integrate-app-into-flow-event.md | Integrate an app into the flow event | [resources/references/adr/2022-06-17-integrate-app-into-flow-event.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-06-17-integrate-app-into-flow-event.md) |
| 2022-06-24-add-typescript-support-for-storefront-js.md | Add typescript support for storefront javascript | [resources/references/adr/2022-06-24-add-typescript-support-for-storefront-js.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-06-24-add-typescript-support-for-storefront-js.md) |
| 2022-06-27-providing-the-admin-extension-sdk.md | Providing the admin extension SDK | [resources/references/adr/2022-06-27-providing-the-admin-extension-sdk.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-06-27-providing-the-admin-extension-sdk.md) |
| 2022-07-19-blog-concept.md | Concept for blogs using Shopping Experiences | [resources/references/adr/2022-07-19-blog-concept.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-07-19-blog-concept.md) |
| 2022-07-21-adding-the-storable-flow-to-implement-delay-action-in-flow-builder.md | Adding the `StorableFlow` instead of the `FlowEvent` for implementing the flow DelayAction in flow builder | [resources/references/adr/2022-07-21-adding-the-storable-flow-to-implement-delay-action-in-flow-builder.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-07-21-adding-the-storable-flow-to-implement-delay-action-in-flow-builder.md) |
| 2022-09-23-add-bootstrap-util.md | Add bootstrap JS-plugin initialization utility to storefront JS | [resources/references/adr/2022-09-23-add-bootstrap-util.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-09-23-add-bootstrap-util.md) |
| 2022-09-27-vue-2.7-update.md | Vue 2.7 update | [resources/references/adr/2022-09-27-vue-2.7-update.md](https://developer.shopware.com/docs/resources/references/adr/2022-09-27-vue-2.7-update.md) |
| 2022-09-28-mapping-of-product-area.md | Mapping of product area | [resources/references/adr/2022-09-28-mapping-of-product-area.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-09-28-mapping-of-product-area.md) |
| 2022-10-17-hide-and-show-cms-content.md | Hide and show CMS content | [resources/references/adr/2022-10-17-hide-and-show-cms-content.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-10-17-hide-and-show-cms-content.md) |
| 2022-10-20-deprecation-handling-during-phpunit-test-execution.md | Deprecation handling during PHPUnit test execution | [resources/references/adr/2022-10-20-deprecation-handling-during-phpunit-test-execution.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-10-20-deprecation-handling-during-phpunit-test-execution.md) |
| 2022-10-20-test-structure.md | Test structure | [resources/references/adr/2022-10-20-test-structure.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-10-20-test-structure.md) |
| 2022-11-09-composer-based-web-updater.md | Composer-based web updater | [resources/references/adr/2022-11-09-composer-based-web-updater.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-11-09-composer-based-web-updater.md) |
| 2022-11-16-deprecate-csrf.md | Deprecate the storefront CSRF implementation | [resources/references/adr/2022-11-16-deprecate-csrf.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-11-16-deprecate-csrf.md) |
| 2022-11-21-replace-drop-shadow-with-box-shadow.md | Replace drop-shadow with box-shadow | [resources/references/adr/2022-11-21-replace-drop-shadow-with-box-shadow.md](https://developer.shopware.com/docs/resources/references/adr/2022-11-21-replace-drop-shadow-with-box-shadow.md) |
| 2022-11-25-run-lighthouse-test-ine2e-env.md | Run Lighthouse tests in E2E env | [resources/references/adr/2022-11-25-run-lighthouse-test-ine2e-env.md](https://developer.shopware.com/docs/resources/references/adr/2022-11-25-run-lighthouse-test-ine2e-env.md) |
| 2022-21-11-replace-drop-shadow-with-box-shadow.md | Replace drop-shadow with box-shadow | [resources/references/adr/2022-21-11-replace-drop-shadow-with-box-shadow.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-21-11-replace-drop-shadow-with-box-shadow.md) |
| 2022-25-11-run-lighthouse-test-ine2e-env.md | Run Lighthouse tests in E2E env | [resources/references/adr/2022-25-11-run-lighthouse-test-ine2e-env.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-25-11-run-lighthouse-test-ine2e-env.md) |
| 2022-27-09-vue-2.7-update.md | Vue 2.7 update | [resources/references/adr/2022-27-09-vue-2.7-update.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2022-27-09-vue-2.7-update.md) |
| 2023-01-10-atomic-theme-compilation.md | Atomic theme compilation | [resources/references/adr/2023-01-10-atomic-theme-compilation.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-01-10-atomic-theme-compilation.md) |
| 2023-01-16-npm-packages-pre-release-versions.md | Npm packages pre-release versions | [resources/references/adr/2023-01-16-npm-packages-pre-release-versions.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-01-16-npm-packages-pre-release-versions.md) |
| 2023-01-30-image-lazy-loading.md | Add native lazy loading for images to the storefront | [resources/references/adr/2023-01-30-image-lazy-loading.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-01-30-image-lazy-loading.md) |
| 2023-02-01-app-script-product-pricing.md | App script product pricing | [resources/references/adr/2023-02-01-app-script-product-pricing.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-02-01-app-script-product-pricing.md) |
| 2023-02-02-deprecate-autoload-true-in-dal-associations.md | Deprecate autoloading associations in DAL entity definitions | [resources/references/adr/2023-02-02-deprecate-autoload-true-in-dal-associations.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-02-02-deprecate-autoload-true-in-dal-associations.md) |
| 2023-02-02-flow-storer-with-scalar-values.md | Flow storer with scalar values | [resources/references/adr/2023-02-02-flow-storer-with-scalar-values.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-02-02-flow-storer-with-scalar-values.md) |
| 2023-02-13-follow-test-pyramid.md | Follow test pyramid | [resources/references/adr/2023-02-13-follow-test-pyramid.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-02-13-follow-test-pyramid.md) |
| 2023-02-20-unstructured-adrs.md | Unstructured ADRs | [resources/references/adr/2023-02-20-unstructured-adrs.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-02-20-unstructured-adrs.md) |
| 2023-02-27-native-extension-system-with-vue.md | Native extension system with vue | [resources/references/adr/2023-02-27-native-extension-system-with-vue.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-02-27-native-extension-system-with-vue.md) |
| 2023-03-27-admin-text-editor-evaluation.md | Admin text editor evaluation | [resources/references/adr/2023-03-27-admin-text-editor-evaluation.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-03-27-admin-text-editor-evaluation.md) |
| 2023-04-01-mocking-repositories.md | Mocking repositories | [resources/references/adr/2023-04-01-mocking-repositories.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-04-01-mocking-repositories.md) |
| 2023-04-03-disable-css-autoprefixer.md | Disable the CSS autoprefixer in the Storefront by default | [resources/references/adr/2023-04-03-disable-css-autoprefixer.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-04-03-disable-css-autoprefixer.md) |
| 2023-04-11-new-language-inheritance-mechanism-for-opensearch.md | New language inheritance mechanism for opensearch | [resources/references/adr/2023-04-11-new-language-inheritance-mechanism-for-opensearch.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-04-11-new-language-inheritance-mechanism-for-opensearch.md) |
| 2023-04-14-jest-test-files-should-be-javascript-only.md | Jest test files should be JavaScript only | [resources/references/adr/2023-04-14-jest-test-files-should-be-javascript-only.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-04-14-jest-test-files-should-be-javascript-only.md) |
| 2023-05-09-optimise-cart-cleanup.md | Optimize cart cleanup | [resources/references/adr/2023-05-09-optimise-cart-cleanup.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-05-09-optimise-cart-cleanup.md) |
| 2023-05-10-experimental-features.md | Experimental features | [resources/references/adr/2023-05-10-experimental-features.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-05-10-experimental-features.md) |
| 2023-05-15-stock-api.md | Stock Manipulation API | [resources/references/adr/2023-05-15-stock-api.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-05-15-stock-api.md) |
| 2023-05-16-php-enums.md | Use PHP 8.1 Enums | [resources/references/adr/2023-05-16-php-enums.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-05-16-php-enums.md) |
| 2023-05-16-symfony-dependency-management.md | Symfony Dependency Management | [resources/references/adr/2023-05-16-symfony-dependency-management.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-05-16-symfony-dependency-management.md) |
| 2023-05-22-switch-to-uuidv7.md | Switch to UUIDv7 | [resources/references/adr/2023-05-22-switch-to-uuidv7.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-05-22-switch-to-uuidv7.md) |
| 2023-05-25-exception-log-levels.md | Exception Log Level configuration | [resources/references/adr/2023-05-25-exception-log-levels.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-05-25-exception-log-levels.md) |
| 2023-06-27-store-api-to-app-server.md | Client side communication to App Server | [resources/references/adr/2023-06-27-store-api-to-app-server.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-06-27-store-api-to-app-server.md) |
| 2023-06-28-default-handle-for-non-specified-salutations.md | Default handling for non specified salutations | [resources/references/adr/2023-06-28-default-handle-for-non-specified-salutations.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-06-28-default-handle-for-non-specified-salutations.md) |
| 2023-07-13-flow-builder-preview.md | Flow Builder Preview | [resources/references/adr/2023-07-13-flow-builder-preview.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-07-13-flow-builder-preview.md) |
| 2023-08-03-collecting-entity-data.md | Collecting and dispatching entity data | [resources/references/adr/2023-08-03-collecting-entity-data.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-08-03-collecting-entity-data.md) |
| 2023-08-17-media-path.md | Media path rewrite | [resources/references/adr/2023-08-17-media-path.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-08-17-media-path.md) |
| 2023-08-27-post-updater.md | Post updater | [resources/references/adr/2023-08-27-post-updater.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-08-27-post-updater.md) |
| 2023-09-06-feature-property-for-experimental-anotation.md | Add Feature property to `@experimental` annotation | [resources/references/adr/2023-09-06-feature-property-for-experimental-anotation.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-09-06-feature-property-for-experimental-anotation.md) |
| 2023-09-22-catalog-import-api.md | Catalog Import API | [resources/references/adr/2023-09-22-catalog-import-api.md](https://developer.shopware.com/docs/v6.5/resources/references/adr/2023-09-22-catalog-import-api.md) |
| 2023-10-17-add-unique-identifiers-for-checkout-methods.md | Introduction of Unique Identifiers for Checkout Methods | [resources/references/adr/2023-10-17-add-unique-identifiers-for-checkout-methods.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-10-17-add-unique-identifiers-for-checkout-methods.md) |
| 2023-10-19-bootstrap-css-utils.md | Make more use of Bootstrap tooling and remove !important from Bootstrap CSS utils | [resources/references/adr/2023-10-19-bootstrap-css-utils.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-10-19-bootstrap-css-utils.md) |
| 2023-11-29-toggle-feature-flag-on-demand.md | Make feature flags toggleable on demand | [resources/references/adr/2023-11-29-toggle-feature-flag-on-demand.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-11-29-toggle-feature-flag-on-demand.md) |
| 2023-12-12-acceptance-test-suite.md | New acceptance test suite | [resources/references/adr/2023-12-12-acceptance-test-suite.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2023-12-12-acceptance-test-suite.md) |
| 2024-02-11-transactional-flow-actions.md | Introduce transactional flow actions | [resources/references/adr/2024-02-11-transactional-flow-actions.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-02-11-transactional-flow-actions.md) |
| 2024-03-11-disable-vue-compat-mode-per-component-level.md | Disable Vue compat mode per component level | [resources/references/adr/2024-03-11-disable-vue-compat-mode-per-component-level.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-03-11-disable-vue-compat-mode-per-component-level.md) |
| 2024-03-21-implementation-of-meteor-component-library.md | Implementation of Meteor Component Library | [resources/references/adr/2024-03-21-implementation-of-meteor-component-library.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-03-21-implementation-of-meteor-component-library.md) |
| 2024-04-01-checkout-gateway.md | Checkout gateway | [resources/references/adr/2024-04-01-checkout-gateway.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-04-01-checkout-gateway.md) |
| 2024-06-12-add-jest-runner-with-disabled-compat-mode.md | Add jest runner with disabled compat mode | [resources/references/adr/2024-06-12-add-jest-runner-with-disabled-compat-mode.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-06-12-add-jest-runner-with-disabled-compat-mode.md) |
| 2024-06-17-error-code-log-level-configuration-in-cloud-and-platform.md | Error-code log Level configuration in platform or cloud | [resources/references/adr/2024-06-17-error-code-log-level-configuration-in-cloud-and-platform.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-06-17-error-code-log-level-configuration-in-cloud-and-platform.md) |
| 2024-06-17-replace-vuex-with-pinia.md | Replace Vuex with Pinia | [resources/references/adr/2024-06-17-replace-vuex-with-pinia.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-06-17-replace-vuex-with-pinia.md) |
| 2024-06-18-extended-event-system.md | Transition to an Event-Based Extension System | [resources/references/adr/2024-06-18-extended-event-system.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-06-18-extended-event-system.md) |
| 2024-07-16-deprecating-sdk-public-api.md | Deprecating Meteor Admin SDK public SDK | [resources/references/adr/2024-07-16-deprecating-sdk-public-api.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-07-16-deprecating-sdk-public-api.md) |
| 2024-07-30-add-telemetry-abstraction-layer.md | Telemetry abstraction layer | [resources/references/adr/2024-07-30-add-telemetry-abstraction-layer.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-07-30-add-telemetry-abstraction-layer.md) |
| 2024-07-31-add-more-unit-tests-namespaces-to-featureflag-extension.md | Add more unit tests namespaces to FeatureFlag extension | [resources/references/adr/2024-07-31-add-more-unit-tests-namespaces-to-featureflag-extension.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-07-31-add-more-unit-tests-namespaces-to-featureflag-extension.md) |
| 2024-08-02-system-health-check.md | System Health Checks in Shopware | [resources/references/adr/2024-08-02-system-health-check.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-08-02-system-health-check.md) |
| 2024-09-26-native-block-system.md | Native Block System in Shopware | [resources/references/adr/2024-09-26-native-block-system.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-09-26-native-block-system.md) |
| 2024-10-02-vue-2-options-api-to-vue-3-composition-api-conversion-codemod.md | Vue 2 Options API to Vue 3 Composition API Conversion Codemod | [resources/references/adr/2024-10-02-vue-2-options-api-to-vue-3-composition-api-conversion-codemod.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-10-02-vue-2-options-api-to-vue-3-composition-api-conversion-codemod.md) |
| 2024-12-19-offer-html-alternative-to-our-pdf-standard-document.md | "\[A11y] Offer HTML alternative to our pdf standard documents" | [resources/references/adr/2024-12-19-offer-html-alternative-to-our-pdf-standard-document.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2024-12-19-offer-html-alternative-to-our-pdf-standard-document.md) |
| 2025-01-01-remove-asterisk-next-to-every-price.md | Remove the asterisk next to every price and replace it with actual text | [resources/references/adr/2025-01-01-remove-asterisk-next-to-every-price.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2025-01-01-remove-asterisk-next-to-every-price.md) |
| 2025-01-29-make-rule-classes-final.md | Make Rule classes final | [resources/references/adr/2025-01-29-make-rule-classes-final.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/2025-01-29-make-rule-classes-final.md) |
| 2025-01-29-make-rule-classes-internal.md | Make Rule classes internal | [resources/references/adr/2025-01-29-make-rule-classes-internal.md](https://developer.shopware.com/docs/resources/references/adr/2025-01-29-make-rule-classes-internal.md) |
| 2025-01-31-move-flow-execution-after-business-process.md | Move flow execution after business process | [resources/references/adr/2025-01-31-move-flow-execution-after-business-process.md](https://developer.shopware.com/docs/resources/references/adr/2025-01-31-move-flow-execution-after-business-process.md) |
| 2025-02-06-deprecate-iterator-iterate.md | Deprecate Iterator.helper in Storefront JS | [resources/references/adr/2025-02-06-deprecate-iterator-iterate.md](https://developer.shopware.com/docs/resources/references/adr/2025-02-06-deprecate-iterator-iterate.md) |
| 2025-04-01-context-gateway.md | Context Gateway | [resources/references/adr/2025-04-01-context-gateway.md](https://developer.shopware.com/docs/resources/references/adr/2025-04-01-context-gateway.md) |
| 2025-05-12-implement-measurement-system.md | Implement measurement system | [resources/references/adr/2025-05-12-implement-measurement-system.md](https://developer.shopware.com/docs/resources/references/adr/2025-05-12-implement-measurement-system.md) |
| 2025-06-03-integrating-the-language-pack-into-platform.md | Integrating the language pack into platform | [resources/references/adr/2025-06-03-integrating-the-language-pack-into-platform.md](https://developer.shopware.com/docs/resources/references/adr/2025-06-03-integrating-the-language-pack-into-platform.md) |
| 2025-08-19-cache-layer-for-navigation-loader.md | Cache layer for navigation loader | [resources/references/adr/2025-08-19-cache-layer-for-navigation-loader.md](https://developer.shopware.com/docs/resources/references/adr/2025-08-19-cache-layer-for-navigation-loader.md) |
| 2025-09-01-adding-a-country-agnostic-language-layer.md | Adding a country-agnostic language layer | [resources/references/adr/2025-09-01-adding-a-country-agnostic-language-layer.md](https://developer.shopware.com/docs/resources/references/adr/2025-09-01-adding-a-country-agnostic-language-layer.md) |
| 2025-09-15-store-api-cache-strategy.md | Caching Strategy for Store API | [resources/references/adr/2025-09-15-store-api-cache-strategy.md](https://developer.shopware.com/docs/resources/references/adr/2025-09-15-store-api-cache-strategy.md) |
| 2025-10-14-colocate-administration-technical-docs.md | Co-locate Administration Technical Documentation with Source Code | [resources/references/adr/2025-10-14-colocate-administration-technical-docs.md](https://developer.shopware.com/docs/resources/references/adr/2025-10-14-colocate-administration-technical-docs.md) |
| 2025-10-23-pin-npm-dependencies.md | Pin All NPM Dependencies to Exact Versions | [resources/references/adr/2025-10-23-pin-npm-dependencies.md](https://developer.shopware.com/docs/resources/references/adr/2025-10-23-pin-npm-dependencies.md) |
| 2025-10-28-changelog-release-info-process.md | Replace changelog ADR with "Changelog & Release Info Process" | [resources/references/adr/2025-10-28-changelog-release-info-process.md](https://developer.shopware.com/docs/resources/references/adr/2025-10-28-changelog-release-info-process.md) |
| 2025-11-03-improved-http-cache-layer.md | Improved HTTP Cache Layer | [resources/references/adr/2025-11-03-improved-http-cache-layer.md](https://developer.shopware.com/docs/resources/references/adr/2025-11-03-improved-http-cache-layer.md) |
| 2025-11-14-introduce-product-type-and-deprecate-states.md | Introduce Product Type And Deprecate Product States | [resources/references/adr/2025-11-14-introduce-product-type-and-deprecate-states.md](https://developer.shopware.com/docs/resources/references/adr/2025-11-14-introduce-product-type-and-deprecate-states.md) |
| _superseded | Feature flag system | [resources/references/adr/_superseded/2020-08-10-feature-flag-system.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/_superseded/2020-08-10-feature-flag-system.md) |
| _superseded | Handling feature flags | [resources/references/adr/_superseded/2020-08-19-handling-feature-flags.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/_superseded/2020-08-19-handling-feature-flags.md) |
| _superseded | Deprecation strategy | [resources/references/adr/_superseded/2021-01-21-deprecation-strategy.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/_superseded/2021-01-21-deprecation-strategy.md) |
| _superseded | Catalog Import API | [resources/references/adr/_superseded/2023-09-22-catalog-import-api.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/_superseded/2023-09-22-catalog-import-api.md) |
| _superseded.md | _superseded.md | [resources/references/adr/_superseded.md](https://developer.shopware.com/docs/v6.6/resources/references/adr/_superseded.md) |
| admin | 2020-08-21 - Notification titles are pre-defined and make use of the global namespace | [resources/references/adr/admin/2020-08-21-unified-notification-titles.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2020-08-21-unified-notification-titles.md) |
| admin | 2020-08-28 - Import ACL privileges from other roles | [resources/references/adr/admin/2020-08-28-import-acl-privileges-from-other-roles.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2020-08-28-import-acl-privileges-from-other-roles.md) |
| admin | 2020-09-17 - The best-practice to always re-fetch the data after saving | [resources/references/adr/admin/2020-09-17-the-best-practice-to-always-re-fetch-the-data-after-saving.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2020-09-17-the-best-practice-to-always-re-fetch-the-data-after-saving.md) |
| admin | 2021-05-28 - Vue Administration App has ESLint support | [resources/references/adr/admin/2021-05-28-introduce-eslint-on-vue-admin.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2021-05-28-introduce-eslint-on-vue-admin.md) |
| admin | 2021-06-14 - Introduce jest-fail-on-console | [resources/references/adr/admin/2021-06-14-introduce-jest-fail-on-console.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2021-06-14-introduce-jest-fail-on-console.md) |
| admin | 2021-08-31 - Refactor admin build process to webpack-multi-compiler mode | [resources/references/adr/admin/2021-08-31-refactor-admin-build-process-to-webpack-multi-compiler-mode.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2021-08-31-refactor-admin-build-process-to-webpack-multi-compiler-mode.md) |
| admin | 2021-11-22 - Merge E2E projects into a single project | [resources/references/adr/admin/2021-11-22-merge-e2e-projects-into-a-single-project.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2021-11-22-merge-e2e-projects-into-a-single-project.md) |
| admin | 2021-11-23 - Add possibility for plugins to add a HTML file | [resources/references/adr/admin/2021-11-23-add-possibility-for-plugin-to-add-a-html-file.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2021-11-23-add-possibility-for-plugin-to-add-a-html-file.md) |
| admin | 2021-12-07 - Admin-Extension-API standards | [resources/references/adr/admin/2021-12-07-admin-extension-api-standards.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2021-12-07-admin-extension-api-standards.md) |
| admin | 2022-03-15 - Extract data handling classes to extension sdk | [resources/references/adr/admin/2022-03-15-extract-data-handling-classes-to-extension-sdk.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2022-03-15-extract-data-handling-classes-to-extension-sdk.md) |
| admin | 15.06.2022 - providing the Admin Extension SDK | [resources/references/adr/admin/2022-06-27-providing-the-admin-extension-sdk.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2022-06-27-providing-the-admin-extension-sdk.md) |
| admin | 17.10.2022 - Hide and Show CMS Content | [resources/references/adr/admin/2022-10-17-hide-and-show-cms-content.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2022-10-17-hide-and-show-cms-content.md) |
| admin | 2022-10-20 - Test structure | [resources/references/adr/admin/2022-10-20-test-structure.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2022-10-20-test-structure.md) |
| admin | 2022-21-11 - Replace drop-shadow with box-shadow | [resources/references/adr/admin/2022-21-11-replace-drop-shadow-with-box-shadow.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2022-21-11-replace-drop-shadow-with-box-shadow.md) |
| admin | 2022-21-11 - Run Lighthouse tests in E2E env | [resources/references/adr/admin/2022-25-11-run-lighthouse-test-ine2e-env.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2022-25-11-run-lighthouse-test-ine2e-env.md) |
| admin | 2022-27-09 - Vue 2.7 update | [resources/references/adr/admin/2022-27-09-vue-2.7-update.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2022-27-09-vue-2.7-update.md) |
| admin | 2023-16-01 - Npm packages pre-release versions | [resources/references/adr/admin/2023-16-01-npm-packages-pre-release-versions.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/2023-16-01-npm-packages-pre-release-versions.md) |
| admin | flow-builder.md | [resources/references/adr/admin/flow-builder.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/flow-builder.md) |
| admin | 2022-07-21 Adding the `StorableFlow` instead of the `FlowEvent` for implementing the flow DelayAction in Flow Builder | [resources/references/adr/admin/flow-builder/2022-07-21-adding-the-StorableFlow-to-implement-DelayAction-in-Flow-Builder.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin/flow-builder/2022-07-21-adding-the-StorableFlow-to-implement-DelayAction-in-Flow-Builder.md) |
| admin.md | admin.md | [resources/references/adr/admin.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/admin.md) |
| api | 2020-07-02 - Implement sales channel context token requirement for store-api and sales-channel-api | [resources/references/adr/api/2020-07-02-implement-sales-channel-context-token-requirement.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/api/2020-07-02-implement-sales-channel-context-token-requirement.md) |
| api | 2020-11-20 - Add the login required annotation | [resources/references/adr/api/2020-11-20-add-login-required-annotation.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/api/2020-11-20-add-login-required-annotation.md) |
| api | 2020-12-02 - API version removal | [resources/references/adr/api/2020-12-02-removing-api-version.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/api/2020-12-02-removing-api-version.md) |
| api | 2022-02-09 - Move controller level annotation into Symfony route annotation | [resources/references/adr/api/2022-02-09-controller-configuration-route-defaults.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/api/2022-02-09-controller-configuration-route-defaults.md) |
| api.md | api.md | [resources/references/adr/api.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/api.md) |
| app | 2020-08-12 - Implement app system inside platform | [resources/references/adr/app/2020-08-12-implement-app-system-inside-platform.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/app/2020-08-12-implement-app-system-inside-platform.md) |
| app | 2021-08-31 - Technical concept custom entities | [resources/references/adr/app/2021-09-14-technical-concept-custom-entities.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/app/2021-09-14-technical-concept-custom-entities.md) |
| app | 2021-10-21 - (App-) Scripts | [resources/references/adr/app/2021-10-21-app-scripting.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/app/2021-10-21-app-scripting.md) |
| app | 2022-01-06 - Allow apps to define custom api endpoints | [resources/references/adr/app/2022-01-06-custom-app-api-endpoints.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/app/2022-01-06-custom-app-api-endpoints.md) |
| app | 2022-02-21 - Rule Scripting in apps | [resources/references/adr/app/2022-02-21-rule-scripting-in-apps.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/app/2022-02-21-rule-scripting-in-apps.md) |
| app | 2022-04-19 - Integrate an app into flow action | [resources/references/adr/app/2022-04-19-integrate-app-into-flow-action.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/app/2022-04-19-integrate-app-into-flow-action.md) |
| app.md | app.md | [resources/references/adr/app.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/app.md) |
| assets.md | assets.md | [resources/references/adr/assets.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/assets.md) |
| cache | 2022-03-09 - Use `ResetInterface` to reset instance state during requests | [resources/references/adr/cache/2022-03-09-reset-class-state-during-requests.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/cache/2022-03-09-reset-class-state-during-requests.md) |
| cache | 2022-03-25 - Cache stampede protection | [resources/references/adr/cache/2022-03-25-cache-stampede-protection.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/cache/2022-03-25-cache-stampede-protection.md) |
| cache.md | cache.md | [resources/references/adr/cache.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/cache.md) |
| checkout | 2020-08-12 - Document template refactoring | [resources/references/adr/checkout/2020-08-12-document-template-refactoring.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/checkout/2020-08-12-document-template-refactoring.md) |
| checkout | 2020-08-14 - Merchant Registration | [resources/references/adr/checkout/2020-08-14-merchant-registration.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/checkout/2020-08-14-merchant-registration.md) |
| checkout | 2020-03-24 - Processing of nested line items | [resources/references/adr/checkout/2021-03-24-nested-line-items.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/checkout/2021-03-24-nested-line-items.md) |
| checkout | 2021-09-06 - Make Core mail templates independent from Storefront urls | [resources/references/adr/checkout/2021-09-06-make-core-mail-templates-independent-from-storefront-urls.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/checkout/2021-09-06-make-core-mail-templates-independent-from-storefront-urls.md) |
| checkout | 2021-10-01 - Payment Flow | [resources/references/adr/checkout/2021-10-01-payment-flow.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/checkout/2021-10-01-payment-flow.md) |
| checkout | 2021-10-13 - Refund handling | [resources/references/adr/checkout/2021-10-13-refund-handling.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/checkout/2021-10-13-refund-handling.md) |
| checkout | 2022-03-17 - New templates for line items and nested line items | [resources/references/adr/checkout/2022-03-17-new-nested-line-items.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/checkout/2022-03-17-new-nested-line-items.md) |
| checkout | 2022-04-28 - Introducing tax providers | [resources/references/adr/checkout/2022-04-28-tax-providers.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/checkout/2022-04-28-tax-providers.md) |
| checkout.md | checkout.md | [resources/references/adr/checkout.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/checkout.md) |
| content-management | 2022-07-18 - Concept for blogs using Shopping Experiences | [resources/references/adr/content-management/2022-07-19-blog-concept.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/content-management/2022-07-19-blog-concept.md) |
| content-management.md | content-management.md | [resources/references/adr/content-management.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/content-management.md) |
| dal | 2020-07-02 - Get control of association clone behavior as developer | [resources/references/adr/dal/2020-07-02-control-clone-behavior.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/dal/2020-07-02-control-clone-behavior.md) |
| dal | 2020-11-19 - DAL join filter | [resources/references/adr/dal/2020-11-19-dal-join-filter.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/dal/2020-11-19-dal-join-filter.md) |
| dal | 2021-05-14 - When to use plain SQL or the DAL | [resources/references/adr/dal/2021-05-14-when-to-use-plain-sql-or-dal.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/dal/2021-05-14-when-to-use-plain-sql-or-dal.md) |
| dal | 2022-03-29 - Specify priority of translations in DAL write payloads | [resources/references/adr/dal/2022-03-29-specify-priority-of-translations-in-dal-write-payloads.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/dal/2022-03-29-specify-priority-of-translations-in-dal-write-payloads.md) |
| dal | 2023-02-02 - Deprecate autoloading associations in DAL entity definitions | [resources/references/adr/dal/2023-02-02-deprecate-autoload-true-in-dal-associations.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/dal/2023-02-02-deprecate-autoload-true-in-dal-associations.md) |
| dal.md | dal.md | [resources/references/adr/dal.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/dal.md) |
| deployment | 2021-08-11 - Make shopware/platform stand-alone for development and testing | [resources/references/adr/deployment/2021-08-11-make-platform-stand-alone.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/deployment/2021-08-11-make-platform-stand-alone.md) |
| deployment | 2022-11-09 - Composer-based web updater | [resources/references/adr/deployment/2022-11-09-composer-based-web-updater.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/deployment/2022-11-09-composer-based-web-updater.md) |
| deployment.md | deployment.md | [resources/references/adr/deployment.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/deployment.md) |
| extension | 2020-09-08 - CustomField label loading in storefront | [resources/references/adr/extension/2020-09-08-custom-field-label-loading-in-storefront.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/extension/2020-09-08-custom-field-label-loading-in-storefront.md) |
| extension | 2020-11-06 - Creating events in Shopware | [resources/references/adr/extension/2020-11-06-creating-events.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/extension/2020-11-06-creating-events.md) |
| extension | 2020-11-25 - Decoration pattern | [resources/references/adr/extension/2020-11-25-decoration-pattern.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/extension/2020-11-25-decoration-pattern.md) |
| extension.md | extension.md | [resources/references/adr/extension.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/extension.md) |
| general | adr.md | [resources/references/adr.md](https://developer.shopware.com/docs/v6.6/resources/references/adr.md) |
| inventory | 2020-08-14 - Implement Individual Sorting | [resources/references/adr/inventory/2020-08-14-implement-individual-sorting.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/inventory/2020-08-14-implement-individual-sorting.md) |
| inventory | 2022-03-25 - Available stock improvements | [resources/references/adr/inventory/2022-03-25-available-stock.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/inventory/2022-03-25-available-stock.md) |
| inventory.md | inventory.md | [resources/references/adr/inventory.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/inventory.md) |
| performance | 2021-11-09 - Introduce increment pattern | [resources/references/adr/performance/2021-11-09-increment-pattern.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/performance/2021-11-09-increment-pattern.md) |
| performance | 2022-03-25 - Base context factory | [resources/references/adr/performance/2022-03-25-base-context-factory.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/performance/2022-03-25-base-context-factory.md) |
| performance | 2022-03-25 - Initial state id loader | [resources/references/adr/performance/2022-03-25-initial-state-id-loader.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/performance/2022-03-25-initial-state-id-loader.md) |
| performance | 2022-03-25 - Prevent mail updates | [resources/references/adr/performance/2022-03-25-prevent-mail-updates.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/performance/2022-03-25-prevent-mail-updates.md) |
| performance | 2022-03-25 Profiler integrations | [resources/references/adr/performance/2022-03-25-profiler-integrations.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/performance/2022-03-25-profiler-integrations.md) |
| performance | 2022-03-25 - Redis cart persister | [resources/references/adr/performance/2022-03-25-redis-cart-persister.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/performance/2022-03-25-redis-cart-persister.md) |
| performance.md | performance.md | [resources/references/adr/performance.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/performance.md) |
| rule | 2021-11-02 - Preparing data for rule evaluation | [resources/references/adr/rule/2021-11-02-preparing-data-for-rule-evaluation.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/rule/2021-11-02-preparing-data-for-rule-evaluation.md) |
| rule | 2022-05-23 - Rule condition field abstraction | [resources/references/adr/rule/2022-05-23-rule-condition-field-abstraction.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/rule/2022-05-23-rule-condition-field-abstraction.md) |
| rule.md | rule.md | [resources/references/adr/rule.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/rule.md) |
| storefront | 2021-07-22 - Move storefront script to head with defer | [resources/references/adr/storefront/2021-07-22-move-storefront-scripts-to-head.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront/2021-07-22-move-storefront-scripts-to-head.md) |
| storefront | 2021-08-10 - Storefront coding standars | [resources/references/adr/storefront/2021-08-10-storefront-coding-standards.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront/2021-08-10-storefront-coding-standards.md) |
| storefront | 2021-09-22 - Refactor theme inheritance | [resources/references/adr/storefront/2021-09-22-refactor-theme-inheritance.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront/2021-09-22-refactor-theme-inheritance.md) |
| storefront | 2022-01-05 - Add feature flag support for Storefront SCSS | [resources/references/adr/storefront/2022-01-05-add-feature-flag-support-for-storefront-scss.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront/2022-01-05-add-feature-flag-support-for-storefront-scss.md) |
| storefront | 2022-06-24 - Add TypeScript support for Storefront JavaScript | [resources/references/adr/storefront/2022-06-24-add-typescript-support-for-storefront-js.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront/2022-06-24-add-typescript-support-for-storefront-js.md) |
| storefront | 2022-09-23 - Add Bootstrap JS-plugin initialization utility to Storefront JS | [resources/references/adr/storefront/2022-09-23-add-bootstrap-util.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront/2022-09-23-add-bootstrap-util.md) |
| storefront | 2022-11-16 - Deprecate the Storefront CSRF implementation | [resources/references/adr/storefront/2022-11-16-deprecate-csrf.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront/2022-11-16-deprecate-csrf.md) |
| storefront | 2023-01-10 - Atomic Theme Compilation | [resources/references/adr/storefront/2023-01-10-atomic-theme-compilation.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront/2023-01-10-atomic-theme-compilation.md) |
| storefront | 2023-01-30 - Add native lazy loading for images to the Storefront | [resources/references/adr/storefront/2023-01-30-image-lazy-loading.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront/2023-01-30-image-lazy-loading.md) |
| storefront.md | storefront.md | [resources/references/adr/storefront.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/storefront.md) |
| testing | 2022-10-20 - Deprecation Handling during PHPUnit Test Execution | [resources/references/adr/testing/2022-10-20-deprecation-handling-during-phpunit-test-execution.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/testing/2022-10-20-deprecation-handling-during-phpunit-test-execution.md) |
| testing | 2023-01-04 - Mocking repositories | [resources/references/adr/testing/2023-04-01-mocking-repositories.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/testing/2023-04-01-mocking-repositories.md) |
| testing.md | testing.md | [resources/references/adr/testing.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/testing.md) |
| workflow | 2020-06-25 - Implement architecture decision records | [resources/references/adr/workflow/2020-06-25-implement-architecture-decision-records.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2020-06-25-implement-architecture-decision-records.md) |
| workflow | 2020-08-03 - Implement New Changelog | [resources/references/adr/workflow/2020-08-03-implement-New-Changelog.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2020-08-03-implement-New-Changelog.md) |
| workflow | 2020-08-10 - Feature flag system | [resources/references/adr/workflow/2020-08-10-feature-flag-system.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2020-08-10-feature-flag-system.md) |
| workflow | 2020-08-12 - Handling feature flags | [resources/references/adr/workflow/2020-08-19-handling-feature-flags.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2020-08-19-handling-feature-flags.md) |
| workflow | 2021-01-21 - Deprecation Strategy | [resources/references/adr/workflow/2021-01-21-deprecation-strategy.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2021-01-21-deprecation-strategy.md) |
| workflow | 2021-11-05 - Adjust ADR approval rules for the new org structure | [resources/references/adr/workflow/2021-11-05-adjust-ADR-approval-rules.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2021-11-05-adjust-ADR-approval-rules.md) |
| workflow | 2022-01-20 - Feature flags for major versions | [resources/references/adr/workflow/2022-01-20-feature-flags-for-major-versions.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2022-01-20-feature-flags-for-major-versions.md) |
| workflow | 2022-02-09 - Consistent deprecation notices in Core | [resources/references/adr/workflow/2022-02-28-consistent-deprecation-notices-in-core.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2022-02-28-consistent-deprecation-notices-in-core.md) |
| workflow | 2022-05-12 - Remove static analysis with psalm | [resources/references/adr/workflow/2022-05-12-remove-static-analysis-with-psalm.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2022-05-12-remove-static-analysis-with-psalm.md) |
| workflow | 2022-09-28 - Mapping of Product Area | [resources/references/adr/workflow/2022-09-28-mapping-of-product-area.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow/2022-09-28-mapping-of-product-area.md) |
| workflow.md | workflow.md | [resources/references/adr/workflow.md](https://developer.shopware.com/docs/v6.4/resources/references/adr/workflow.md) |
