Skip to content

Theme Variables

This reference is the compact lookup table for SCSS variables, their theme.json sources, and defaults. For an annotated architecture overview see Variables & Tokens.

Sources

FilePurpose
abstract/variables/bootstrap.scssBootstrap overrides, binds $sw-* tokens to Bootstrap defaults
abstract/variables/custom.scssGuppy-specific tokens (delivery status, product images, focus, icons…)
skin/shopware/abstract/variables/bootstrap.scssShopware integration overrides (Bootstrap)
skin/shopware/abstract/variables/theme.scssShopware integration overrides (theme)
theme.jsonAdmin configuration, populates $sw-* tokens

Brand colors

SCSStheme.jsonDefaultUse
$sw-color-brand-primarysw-color-brand-primary#215AFFPrimary
$sw-color-brand-secondarysw-color-brand-secondary#0B1845Secondary
$sw-background-colorsw-background-color#FFFFFFBackground
$sw-border-colorsw-border-color#CFD1D7Borders
$sw-text-colorsw-text-color#1B1F29Text color
$sw-headline-colorsw-headline-color#1B1F29Headlines

Greyscales

SCSSDefault
$sw-color-gray-100#F9F9F9
$sw-color-gray-200#EEEEEE
$sw-color-gray-300#BCC1C7
$sw-color-gray-400#CED4DA
$sw-color-gray-500#ADB5BD
$sw-color-gray-600#798490
$sw-color-gray-700#495057
$sw-color-gray-800#4A545B
$sw-color-gray-900#212529

Typography

SCSStheme.jsonDefault
$sw-font-size-basesw-font-size-base1rem
$sw-h1-font-sizesw-h1-font-size32px
$sw-h2-font-sizesw-h2-font-size24px
$sw-h3-font-sizesw-h3-font-size20px
$sw-h4-font-sizesw-h4-font-size18px
$sw-h5-font-sizesw-h5-font-size16px
$sw-h6-font-sizesw-h6-font-size15px
$sw-h1-line-heightsw-h1-line-height44px
$sw-h2-line-heightsw-h2-line-height36px
$sw-h3-line-heightsw-h3-line-height32px

Container and padding

SCSSDefault
$guppy-container-width-default1400px
$guppy-container-width-fluid100%
$guppy-container-width-sm1230px
$guppy-container-default-padding-x-mobile10px
$guppy-container-default-padding-x-sm24px
$guppy-container-default-padding-x-md48px
$guppy-container-default-padding-x-lg48px
$guppy-container-default-padding-x-xl48px
$guppy-container-default-padding-x-xxl48px

CMS section padding

SCSStheme.jsonDefault
$guppy-cms-section-padding-xguppy-cms-section-padding-x48px
$guppy-cms-section-padding-yguppy-cms-section-padding-y48px
$guppy-cms-section-padding-y-2xguppy-cms-section-padding-y-2x96px

Buttons and inputs

SCSStheme.jsonDefault
$sw-input-btn-font-sizesw-input-btn-font-size16px
$sw-input-btn-border-radiussw-input-btn-border-radius4px
$sw-input-btn-font-weightsw-input-btn-font-weightnormal

Icons

SCSSDefaultUse
$icon-base-size22pxBase size
$icon-base-colorcurrentColorInherits text color
$icon-accessibility-touch-size44pxMin. touch target (WCAG 2.5.5)

Product images

SCSSDefaultUse
$product-image-height240pxDefault height
$product-image-height-lgfit-contentHeight on large screens
$product-image-aspect-ratio10/9Aspect ratio
$product-image-background$sw-color-product-imageBackground

Accessibility

SCSSDefaultUse
$focus-outline-width2pxFocus outline width
$focus-outline-color$sw-color-brand-primaryFocus outline color
$focus-outline-offset2pxDistance from element
$focus-outline-box-shadow0 0 0 2px #fffAdditional shadow

Delivery status

SCSSDefault
$guppy-delivery-shipping-free-color#023B5A
$guppy-delivery-shipping-free-background#CEEDFE
$guppy-delivery-available-color#154634
$guppy-delivery-available-background#D3F2E7
$guppy-delivery-restock-color#5D3B00
$guppy-delivery-restock-background#FFEFD4
$guppy-delivery-soldout-color#303030
$guppy-delivery-soldout-background#EEEEEE

Badges

theme.jsonDefault
guppy-badges-new-background-color#22C087
guppy-badges-new-color#FFFFFF
guppy-badges-top-seller-background-color#F89C00
guppy-badges-top-seller-color#FFFFFF
guppy-badges-discount-background-color#E10036
guppy-badges-discount-color#FFFFFF

Alerts

theme.jsonDefault
guppy-alert-color-success#D3F2E7
guppy-alert-color-info#CEEDFE
guppy-alert-color-warning#FFEFD4
guppy-alert-color-danger#FDE2E7

Mixins (selection)

MixinPurpose
focus-styleConsistent focus outline
line-height($value)Responsive line height
rlh($value, $property)RLH variant with property choice
button-adaptive-hover($base-color)Hover only for (hover: hover)
text-ellipsisSingle-line ellipsis
text-clamp($lines)Multi-line ellipsis
visually-hiddenScreen-reader-only

Functions

FunctionPurpose
px-to-rem($px)Pixels to rem
strip-unit($value)Strip a unit
shade-color($color, $weight)Darken color (Bootstrap)
tint-color($color, $weight)Lighten color (Bootstrap)
shift-color($color, $weight)Lighten / darken based on lightness (Bootstrap)