Altcademy - a Forbes magazine logo Best Coding Bootcamp 2023

What are Comments in CSS?

CSS, or Cascading Style Sheets, is a language that web developers use to style the appearance of websites. If you're learning to program, chances are you'll come across CSS at some point in your journey. As you work on more complex projects, you'll find that keeping track of all the styles and rules can become quite challenging. This is where comments come in handy. In this blog post, we'll discuss what comments are, why they are important, and how to use them in your CSS code.

What are comments?

Comments are a way to include notes, explanations, or reminders in your code that are not executed by the browser. They are meant for developers to read and understand the code better. Think of comments as sticky notes or annotations that you can place throughout your code. They can help you remember why you made specific decisions, clarify complex code sections, or communicate with other developers who might be working on the same project.

In CSS, comments are enclosed between /* and */. Anything inside these symbols is considered a comment and will be ignored by the browser. Comments can be placed anywhere in your CSS code, and they can span multiple lines.

Here's an example of a CSS comment:

/* This is a single-line comment in CSS */

And here's an example of a multi-line comment:

This is a multi-line comment in CSS.
It can span across multiple lines,
making it easier to explain complex code sections.

Now that you know what comments are let's discuss why they are essential in CSS.

Why are comments important?

Comments are crucial in CSS for several reasons:

Clarification: CSS can get complicated, especially when you have many rules and selectors. Comments can help you clarify what specific rules do, making it easier for you (or other developers) to understand the code.

Organization: You can use comments to divide your code into sections, making it more organized and easier to navigate. This is especially useful in large projects where you might have hundreds or even thousands of lines of CSS code.

Communication: If you're working with a team, comments can help you communicate your thoughts and decisions to other team members. They can also help you understand the code written by others, making collaboration more efficient.

Debugging: Leaving comments in your code can help you remember why you made specific choices, which can be invaluable when debugging issues later on.

Now that you know why comments are important let's look at some examples of how to use them effectively in your CSS code.

How to use comments effectively in CSS

1. Clarifying complex code

Imagine you have a complex CSS rule that applies various styles to a specific element. You can use comments to explain what each part of the rule does, making it easier to understand for anyone reading your code.

/* Style the main navigation menu */
nav {
  background-color: #333; /* Dark background color */
  display: flex; /* Use flex to create horizontal menu */
  justify-content: space-between; /* Space menu items evenly */
  padding: 1rem; /* Add padding around the menu */

In this example, we've added inline comments to explain what each style rule does, making it easier to understand the purpose of each rule.

2. Organizing your code with sections

You can use comments to divide your CSS code into sections, making it more organized and easier to navigate. For example, you might have a section for typography, another for layout, and another for colors.

/* ==========================================================================
   ========================================================================== */
/* Define styles for headings, paragraphs, and other text elements here */

h1, h2, h3, h4, h5, h6 {
  font-family: 'Roboto', sans-serif;
  font-weight: 700;

p {
  font-family: 'Open Sans', sans-serif;
  font-size: 1rem;

/* ==========================================================================
   ========================================================================== */
/* Define styles for the website's layout, such as containers, grid systems, and positioning */

.container {
  max-width: 1200px;
  margin: 0 auto;
  padding: 0 1rem;

/* ==========================================================================
   ========================================================================== */
/* Define color variables and rules for applying colors to elements */

:root {
  --main-color: #007bff;
  --secondary-color: #6c757d;
  --dark-color: #343a40;

In this example, we've used comments to create sections for typography, layout, and colors, making the code more organized and easier to navigate.

3. Communicating decisions

Sometimes, you might make specific choices in your CSS code for a particular reason, and you want to communicate that reason to other developers. You can use comments to do this, making it clear why you made a particular decision.

/* Use a fixed width for the sidebar to avoid content overlap on small screens */
.sidebar {
  width: 300px;
  /* Other sidebar styles... */

In this example, we've used a comment to explain why we've chosen a fixed width for the sidebar.

4. Commenting out code

You can also use comments to temporarily "disable" parts of your CSS code that you don't want to execute. This is useful when you're testing different styles or trying to debug an issue.

/* Temporarily hide the sidebar to test the layout without it */
.sidebar {
  display: none;

/* Other CSS code... */

In this example, we've commented out the sidebar styles to test the layout without it. You can easily "re-enable" the code by removing the comment symbols.


Comments are a powerful tool in CSS that can help you clarify, organize, and communicate your code effectively. They play a crucial role in making your code more readable and maintainable, especially when working with large projects or collaborating with a team. By using comments effectively in your CSS code, you'll make it easier for yourself and others to understand and work with your code, ultimately leading to a better end product.