General Best Practices for Themes

This topic applies to

Applies to

SuiteCommerce Web Stores

The following list provides some general knowledge and practices to remember when customizing themes for SuiteCommerce sites:

  • Use themes to customize HTML templates and Sass for your site.

  • If you are using a published theme as a baseline, the developer tools force you to create a new theme. This new theme includes your changes as a custom theme.

  • Whenever possible, use the existing folder structure as created when you downloaded themes and extensions to your Workspace directory. If you must add new subdirectories, make sure the paths to any files are included in the theme manifest and any required entry points.

  • Do not move, delete, or edit any files located in your Workspace/Extras directory. Any files located here are for reference and overrides only.

  • When you fetch a theme, you also get the HTML and Sass files for any active extensions. You can customize these files to suit your theme using the Override method. See Override Active Extension Files for details.

  • Place any new assets (images or fonts) in the appropriate location within the theme’s assets directory.

  • Use helpers when referencing any assets within your HTML or Sass customizations and overrides. See Asset Best Practices for details.

  • Follow the template context when editing HTML template files or creating overrides. See HTML Best Practices for details.

  • To avoid file name collisions, do not create any new files or folders that share the same name, even if they reside in different locations. The exception to this practice is when working with extension overrides.