Configuring Stores and Catalogs

The Add-On and the CIF Core Components can be used on multiple AEM site structures connected to different commerce stores (or store views, and so on). By default, the CIF Add-On is deployed with a default config connecting to Adobe Commerce’s default store and catalog.

This configuration can be adjusted for the project via the CIF Cloud Service config following these steps:

  1. In AEM go to Tools > Cloud Services > CIF Configuration

  2. Select the commerce configuration you want to change

  3. Open the configuration properties via the action bar

CIF Cloud Services Configuration

The following properties can be configured:

  • GraphQL Client - select the configured GraphQL client for commerce backend communication. This should typically stay at default.

  • Store View - the store view identifier. If empty, the default store view is used.

  • GraphQL Proxy Path - the URL path GraphQL Proxy in AEM use to proxy requests to the commerce backend GraphQL endpoint.

    NOTE
    In most setups the default value /api/graphql must not be changed. Only advanced setup not using the provided GraphQL proxy should change this setting.
  • Enable Catalog UID Support - enable support for UID instead of ID in the commerce backend GraphQL calls.

    NOTE
    Support for UIDs got introduced in Adobe Commerce 2.4.2. Only enable this if your commerce backend supports a GraphQL schema of version 2.4.2 or later.
  • Catalog Root Category Identifier - the identifier (UID or ID) of the store catalog root

    CAUTION
    Starting with CIF Core Components version 2.0.0 the support for id was removed and replaced with uid. If your project uses CIF Core Components version 2.0.0 you must enable Catalog UID Support and use a valid category UID as “Catalog Root Category Identifier”.

The configuration shown above is for reference. Projects should provide their own configurations.

For more complex setups using multiple AEM site structures combined with different commerce catalogs see the Commerce Multi-Store Setup tutorial.

Additional Resources

recommendation-more-help