Update and Deploy Custom Themes in SuiteCommerce

Update the theme version and deploy your custom theme in SuiteCommerce effectively and safeguard your changes.

·2 min read·View Oracle Docs

Updating the theme version in SuiteCommerce is essential for keeping track of your development efforts and ensuring a smooth deployment of custom themes. This article outlines the necessary steps to update your theme version and deploy it correctly.

How to Update the Theme Version

  1. Locate the manifest.json file in your working directory at the top level of your custom theme directory.
  2. Modify the version field in the JSON file; set it to 1.0.1 and save your changes.
  3. To deploy your theme, use the following command from the top-level theme development directory:
    none
    gulp theme:deploy
  4. When prompted, provide specific information about the theme you are deploying. For a comprehensive overview of these prompts, refer to the documentation on deploying themes.

Important Deployment Notes

  • When deploying, ensure you are operating within your local developer environment. Open a command line or terminal and navigate to the top-level development directory.
  • The command gulp theme:deploy compiles your theme and updates the manifest.json file. If you made manual changes to this file that you want to keep, run gulp theme:deploy --preserve-manifest instead.

User Prompts During Deployment

While deploying your theme for the first time, you will be asked for various pieces of information. Here are some prompts that you might encounter:

PromptDescription
Authentication IDAn ID representing your NetSuite account and role.

If you previously set an Authentication ID, the development tools will use that ID for future fetch or deploy operations without prompting.

Conclusion

Following these instructions will help ensure that your custom theme is properly updated and deployed within NetSuite, allowing you to manage your website’s appearance effectively.

Frequently Asked Questions (4)

Do I need a specific environment to deploy custom themes in SuiteCommerce?
Yes, you need to operate within your local developer environment to deploy custom themes. Make sure you open a command line or terminal and navigate to the top-level development directory.
What precautions should I take if I manually changed the manifest.json file?
If you have made manual changes to the manifest.json file and want to keep them, you should deploy using the command 'gulp theme:deploy --preserve-manifest' to ensure your changes are not overwritten.
What is the purpose of the Authentication ID during the theme deployment process?
The Authentication ID represents your NetSuite account and role. It is used to authenticate your identity, and if it was previously set, it will be used in future fetch or deploy operations without requiring you to re-enter it.
Is there a way to deploy a custom theme without modifying the existing manifest.json version?
The standard deployment process updates the manifest.json file version. However, if you wish to deploy the theme while keeping the current version unchanged, you can use the 'gulp theme:deploy --preserve-manifest' command.
Source: Update the Theme Version and Deploy Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?

More in General

View all General articles →