Replacing the Loading Icon in SuiteCommerce Customization

The loading icon image is a key element in the user experience of your SuiteCommerce site. By replacing the default loading icon, you can enhance your site's branding while retaining its original functionality. Here’s how to do it effectively:

How to Replace the Loading Icon Image

To change the loading icon image, you need to replace the image file within your site's source code. The default loading icon file, often named ajax-loader.gif, must be substituted with an alternative image that shares the same name. Note that this process does not disable the underlying JavaScript functionality associated with the loading icon.

Here are the specific paths to find the relevant source code based on your SuiteCommerce version:

• For Kilimanjaro versions of SuiteCommerce Advanced, the loading icon can be found at:
  • Modules/suitecommerce/GlobalImages/images
• For Aconcagua and later versions, the icon is located at:
  • assets/img within your theme's source

Important Considerations

• Avoid Direct Replacement in File Cabinet: Replacing the loading icon directly in the File Cabinet is not advisable, as it will be overwritten when the theme or source code is redeployed.
• Perform Cache Invalidation: After deploying your new loading icon, it’s important to perform a cache invalidation request for the file location to ensure that the new image is served to users. This ensures that cached images are updated.

You can clear the browser cache as well to guarantee that users see the latest loading icon instead of the old one. The loading icon file will typically be served from these locations depending on your SuiteCommerce version:

• https://[domain]/scs/extensions/SC/Threads/3.1.0/img/ajax-loader.gif
• https://[domain]/sca-dev-kilimanjaro/img/ajax-loader.gif

Caching Notes

Cache invalidation does not clear the browser cache, so returning customers may still see the previous loading image until their browser cache expires.

For detailed steps on cache invalidation, refer to the Cache Invalidation documentation.