CSS Variables Explained: A Complete Guide with Examples (Beginner to Advanced)

CSS Variables (also called Custom Properties) are one of the most powerful features in modern CSS. They help you write clean, reusable, and maintainable styles.

In this guide, you’ll learn:

  • What CSS Variables are
  • Why we need them
  • How they work
  • Real-world examples
  • Best practices

What Are CSS Variables?

CSS Variables are custom values that you define and reuse in your CSS.

πŸ‘‰ They start with -- and are accessed using var().


Basic Example

:root {
--primary-color: blue;
}button {
background-color: var(--primary-color);
}

πŸ‘‰ Output:

  • Button background becomes blue

Why Do We Need CSS Variables?

Before CSS Variables, we had problems like:

❌ Repeating same values everywhere
❌ Difficult to update styles
❌ No dynamic theming


Example Without Variables

button {
background-color: blue;
}.header {
color: blue;
}

πŸ‘‰ If you want to change blue β†’ red, you must update everywhere ❌


With CSS Variables

:root {
--primary-color: blue;
}button {
background-color: var(--primary-color);
}.header {
color: var(--primary-color);
}

πŸ‘‰ Change once β†’ updated everywhere βœ…


How CSS Variables Work


πŸ”Ή Defining Variables

:root {
--main-color: green;
}

πŸ‘‰ :root = global scope


πŸ”Ή Using Variables

p {
color: var(--main-color);
}

Scope of CSS Variables


πŸ”Ή Global Scope

:root {
--color: red;
}

πŸ‘‰ Available everywhere


πŸ”Ή Local Scope

.card {
--color: blue;
}.card p {
color: var(--color);
}

πŸ‘‰ Only inside .card


Updating Variables Dynamically

You can update variables using JavaScript:

document.documentElement.style.setProperty('--primary-color', 'red');

πŸ‘‰ Instantly updates UI πŸ”₯


Real-World Use Case: Theme Switching


Light Theme

:root {
--bg-color: white;
--text-color: black;
}

Dark Theme

.dark {
--bg-color: black;
--text-color: white;
}

Usage

body {
background-color: var(--bg-color);
color: var(--text-color);
}

πŸ‘‰ Just toggle .dark class β†’ theme changes instantly


Fallback Values (Very Important)

color: var(--primary-color, red);

πŸ‘‰ If variable not defined β†’ fallback to red


Advanced Example

:root {
--spacing: 10px;
}.container {
padding: calc(var(--spacing) * 2);
}

πŸ‘‰ Works with calculations πŸ”₯


πŸ†š CSS Variables vs SCSS Variables

FeatureCSS VariablesSCSS Variables
Runtime changeβœ… Yes❌ No
Works in browserβœ… Yes❌ Precompiled
Dynamic themesβœ… Yes❌ No

Best Practices

  • Use meaningful names (--primary-color)
  • Define global variables in :root
  • Avoid overusing variables
  • Use for themes and reusable values

Where CSS Variables Are Used

  • React (MUI, Tailwind configs)
  • Theming systems
  • Design systems
  • Dark/light mode

Interview Tip

If asked:

β€œWhat are CSS variables?”

πŸ‘‰ Answer:

β€œCSS variables are reusable custom properties that allow dynamic styling and runtime updates in CSS.”


🏁 Final Summary

  • CSS Variables improve maintainability
  • They support dynamic updates
  • Useful for themes and reusable styles
  • Work directly in browser

Related Articles


πŸ’‘ Found this helpful? Subscribe to get simple frontend tutorials, real-world examples, and developer tips. Happy Coding!