Migrating Stylesheets in Oracle CPQ Cloud

Since its inception, Oracle CPQ Cloud (aka BigMachines) was more about functionality and less about design and style. Out of the box, the platform provides basic styling, but most implementations require custom CSS to match corporate branding and improve user experience.

The Problem with Alternate Stylesheets

Traditionally, Oracle CPQ Cloud uses the Stylesheet Manager to upload an “Alternate CSS File.” However, this approach has significant limitations:

• The alternate stylesheets are not migratable through Migration Center (as per Oracle help documentation)
• There is no way to compare the style changes between environments
• It’s confusing and may take a longer time to migrate manually

These limitations cause significant headaches when promoting changes from development to test to production environments.

The Solution: Use File Manager

Instead of using the Stylesheet Manager, store your CSS files in the File Manager and import them using the @import directive.

Step 1: Create your CSS file

Create a folder called style in the File Manager and upload your CSS file (e.g., alternate.css).

Step 2: Reference from Global Stylesheet

In the Stylesheet Manager’s main stylesheet, add an import statement:

Benefits of This Approach

• Migrate the stylesheet through Migration Center (WOW!!!)
• Ability to compare the style changes before migration
• It becomes part of your migration and takes a click to select the file
• You can have multiple CSS files for different modules

Organizing Multiple Stylesheets

With this approach, you can organize your CSS into logical modules:

Best Practices

• Use meaningful file names that indicate purpose
• Keep files modular — one file per section or module
• Document your CSS structure for your team
• Include the CSS folder in your regular migration packages
• Test in all environments before going to production

By adopting this approach, you’ll have better control over your Oracle CPQ Cloud stylesheets, easier migrations, and the ability to track and compare changes across environments.