How to customize store components

Introduction to Using CSS to Customize Your Store’s Look & Feel

Customizing your store’s appearance is essential to creating a unique brand identity and enhancing the shopping experience for your customers. HeadQ offers two ways to change store components look and feel.

  1. Pre-made options for controlling certain appearance characteristics are available, allowing for quick adjustments

  2. For more detailed customization, you can use Custom CSS (Cascading Style Sheets)

Quick adjustments

You can find basic tools to change your store’s appearance in the settings, such as adjusting button colors, accent colors, and element rounding.

Pre-made options are available under the store settings and appearance view.

You can customize CPQ visual elements individually in the settings of each CPQ.

Custom CSS

For more detailed customization, you can use CSS to style specific elements. Custom CSS can be applied directly from the appearance dialog.

There are a few predefined CSS variables added to the root element that allow you to easily adjust the look and feel of your store. The following variables are currently in use:

Variable Default Description
--hq-bg-color #FFFFFF Background color that is used in different layers
--hq-primary-color  #FFFFFF Not in use
--hq-secondary-color #FFFFFF Not in use
--hq-accent-color #FFFFFF Accent color for inputs and hightlight color for selections
--hq-mood-color #FFFFFF Primary button background
--hq-border-color rgb(209, 213, 219) Border color used for inputs and layers
--hq-border-radius 8px Rounding radius for different elements
--hq-text-color #000000 Primary text color
--hq-text-color-secondary #000000 Secondary text color

You can, for example, change the background color of layers to dark gray by overriding the default value with custom CSS.

 :root {
  --hq-bg-color: #5A5A5A;
}

 Element classes

Each HeadQ component has its own classes that you can use for adjusting the styles of the components.

Class Description
headq-item-layer

Layer container that is used when configuring certain product
headq-item-layer-image Item container used in product layer.
headq-configurator-layer Container for CPQ
headq-cart-layer Cart container
headq-cart-item Single line item row inside cart
headq-cart-item-image Single line item row image container
headq-cart-item-description Single line item row description container
headq-primary-button Primary button used in different view
headq-checkout-form Checkout form input container
headq-checkout-itenary Checkout form itenary container

For example, if you want to add transparency to your product configuration layer, you could add the following styles in the custom CSS field:

.headq-item-layer {
  opacity: 0.8;
}
 

In conclusion, customizing your store’s appearance is crucial for creating a unique and engaging shopping experience that aligns with your brand identity. Whether you’re using the basic tools provided in the store settings or diving into more advanced customization with CSS, you have the flexibility to tailor every aspect of your store’s design. By taking advantage of predefined CSS variables and component-specific classes, you can easily make your store visually distinct and user-friendly. Embracing these customization options not only enhances the aesthetic appeal of your store but also contributes to a more cohesive and professional online presence.