Cartridge paths for multiple sites and brands on one instance
Key Takeaway
Uploading a cartridge does not make it run. Each site's cartridge path decides what runs, and B2C Commerce reads that path from left to right. List a brand's custom cartridge to the left of the plug-in and base cartridges it extends.
A cartridge path is the ordered, colon-separated list of cartridges that a site uses. B2C Commerce searches the list from left to right and uses the first matching controller, template, or script it finds, so the order decides which code runs. Because each site has its own cartridge path, several sites and brands on one instance can share most cartridges and differ only in a few custom ones.
Cartridges and the cartridge path
A storefront needs at least one cartridge and usually has several.
B2C Commerce always searches the cartridge path from left to right and uses the first controller or pipeline it finds with a given name. As a result, cartridges earlier on the path (to the left) override cartridges later on the path (to the right).