How to use Comments in CSS

Comments in CSS are used to add notes or explanations to your code that are not visible to users. Comments are a useful way to document your code, make notes to yourself, or communicate with other developers who may be working on the same project. In this guide, we’ll show you how to use comments in CSS.


CSS comments are created using the /* and */ characters. Anything between these characters is treated as a comment and is ignored by the browser. Here’s an example:

/* This is a CSS comment */

This comment will be ignored by the browser and will not affect the rendering of the web page.

Multi-Line Comments

Multi-line comments are used to add longer notes or explanations to your code. They are created using the same syntax as single-line comments, but can span multiple lines. Here’s an example:

This is a multi-line CSS comment.
It can span multiple lines
and is useful for longer notes or explanations.

This comment will also be ignored by the browser and will not affect the rendering of the web page.

Commenting Out Code

Comments are also useful for temporarily disabling or “commenting out” code that you don’t want to use. For example, if you want to test a different color scheme for your website, you can comment out the existing code and add the new code as follows:

background-color: #007bff; // Commented out the existing code

background-color: #ff7f50; /* Added new code */

In this example, the existing code is commented out by adding /* and */ characters around it. The new code is added after the commented out code.

Best Practices

Here are some best practices to keep in mind when using comments in CSS:

  • Use comments sparingly and only when necessary. Too many comments can clutter your code and make it harder to read.
  • Use clear and concise language in your comments to make them easy to understand.
  • Avoid commenting on obvious code. For example, commenting color: red; /* Sets the color to red */ is not necessary because it’s already clear what the code does.
  • Keep your comments up-to-date. If you make changes to your code, make sure to update any relevant comments.

Comments are a powerful tool for documenting your CSS code and communicating with other developers. By using comments effectively, you can make your code more readable and easier to maintain.