Fix Missing Theme Skins in SuiteCommerce

Are your SuiteCommerce theme skins missing from Site Management Tools (SMT), even though you've installed and activated a theme?

We encountered this issue while setting up a SuiteCommerce Advanced storefront using NetSuite's Threads theme. Although the theme appeared to be installed correctly, the expected theme customization options did not appear in SMT.

In our case, updating the Extension Management bundle resolved the problem.

Here's how we identified the issue and the steps we used to fix it.

The Problem: Theme Skins Don't Appear in SMT

SuiteCommerce themes provide storefront styling options, including predefined theme skins.

These skins allow administrators to work with supported visual settings, such as colors and typography, without editing the underlying theme code for every change.

Normally, you can access the available theme customization options through Site Management Tools.

However, when we opened SMT for the affected storefront, the Themes option was missing.

How to Identify the Issue

1. Open your SuiteCommerce storefront.
2. Press Esc to access Site Management Tools.
3. Sign in with your NetSuite credentials if prompted.
4. Select the pencil icon to enter editing mode.
5. Open the gear icon menu.

If the expected Themes option is missing, you may be experiencing the same issue.

When investigating the problem, we also found the following error in the browser's developer console:

{
  "readyState": 4,
  "status": 404,
  "statusText": "error"
}

A 404 response indicates that a requested resource was not found. It doesn't identify the underlying cause on its own, but it provided an additional clue during troubleshooting.

Solution: Update the Extension Management Bundle

In our implementation, the missing theme skins were resolved by updating the Extension Management bundle.

Step 1: Review the Installed Extension Management Bundle

In NetSuite, navigate to:

Customization > SuiteBundler > Search & Install Bundles > List

Locate the Extension Management bundle in the installed bundle list.

Check whether an update is available.

Step 2: Update Extension Management

If an update is available, select the update option beside the Extension Management bundle.

Follow the prompts to complete the update.

Once the process finishes, confirm that the bundle shows a successful installation or update status.

Step 3: Invalidate the Storefront Cache

After the bundle update, perform the appropriate cache invalidation for your SuiteCommerce website.

This helps ensure that the storefront retrieves updated resources rather than continuing to use cached files.

Step 4: Refresh the Storefront

Open the storefront and perform a hard refresh.

For example:

• Windows: Ctrl + Shift + R
• Mac: Command + Shift + R

Then return to Site Management Tools.

Step 5: Verify That Theme Skins Are Available

Press Esc to access SMT and sign in if prompted.

Select the pencil icon to enter editing mode, then open the gear icon menu.

In our case, the Themes option and available theme skins appeared after the Extension Management update and cache refresh.

Other Troubleshooting Steps

If updating Extension Management doesn't resolve the issue, there are a few additional areas worth investigating.

1. Check for Conflicting Extensions

Other installed extensions may interfere with storefront behavior.

In a sandbox or other controlled testing environment, try activating the theme with only the extensions required for the test.

For example, our troubleshooting included testing the theme alongside its required Core Content components.

If the theme skins appear with nonessential extensions disabled, investigate which extension or configuration may be causing the conflict.

2. Review SuiteCommerce Bundle Versions

Check whether the relevant SuiteCommerce and SuiteCommerce Advanced bundles are compatible with the installed theme and extensions.

Outdated or incompatible components can cause unexpected behavior in Site Management Tools.

Before updating bundles, review the applicable release requirements and dependencies.

3. Test Another Supported Theme

If the problem persists, try a different compatible NetSuite theme in a testing environment.

Depending on the themes available in your account, examples may include:

• Threads
• Posh
• Manor

If theme skins appear for one theme but not another, that comparison can help narrow the issue to a specific theme or extension configuration.

Protect Your SuiteCommerce Configuration Before Troubleshooting

Before changing bundles, themes, or extensions, preserve your existing SuiteCommerce configuration.

In particular, save a copy of the relevant Configuration JSON so you have a reference for the current settings.

Changes to extensions or theme configurations can affect storefront behavior, and restoring an earlier configuration may require more than simply reactivating a theme.

Testing in sandbox before making production changes can reduce the risk of disrupting the live storefront.

Final Thoughts

When SuiteCommerce theme skins fail to appear in Site Management Tools, the issue may involve the installed theme, Extension Management bundle, or another storefront component.

In our case, updating the Extension Management bundle, invalidating the cache, and refreshing the storefront restored the missing theme customization options.

If the same steps don't resolve your issue, compare bundle versions, review extension compatibility, and test the theme in a controlled environment to narrow down the cause.