Skip to main content

comment-empty-line-before

Require or disallow an empty line before comments.

a {}              /* ← *//* comment */ /* ↑ *//**              ↑*        This line */

This rule ignores:

  • comments that are the very first node in the source
  • shared-line comments
  • single-line comments with // (when you're using a custom syntax that supports them)
  • comments within selector and value lists

The fix option can automatically fix all of the problems reported by this rule. We recommend to enable indentation rule for better autofixing results with this rule.

Options#

string: "always"|"never"

"always"#

There must always be an empty line before comments.

The following patterns are considered problems:

a {}/* comment */

The following patterns are not considered problems:

a {}
/* comment */
a {} /* comment */

"never"#

There must never be an empty line before comments.

The following patterns are considered problems:

a {}
/* comment */

The following patterns are not considered problems:

a {}/* comment */
a {} /* comment */

Optional secondary options#

except: ["first-nested"]#

Reverse the primary option for comments that are nested and the first child of their parent node.

For example, with "always":

The following patterns are considered problems:

a {
  /* comment */  color: pink;}

The following patterns are not considered problems:

a {  /* comment */  color: pink;}

ignore: ["after-comment", "stylelint-commands"]#

"after-comment"#

Ignore comments that follow another comment.

For example, with "always":

The following patterns are not considered problems:

a {  background: pink;
  /* comment */  /* comment */  color: #eee;}
a {  background: pink;
  /* comment */
  /* comment */  color: #eee;}

"stylelint-commands"#

Ignore comments that deliver commands to stylelint, e.g. /* stylelint-disable color-no-hex */.

For example, with "always":

The following patterns are considered problems:

a {  background: pink;  /* not a Stylelint command */  color: #eee;}

The following patterns are not considered problems:

a {  background: pink;  /* stylelint-disable color-no-hex */  color: pink;}

ignoreComments: ["/regex/", /regex/, "string"]#

Ignore comments matching the given regular expressions or strings.

For example, with "always" and given:

["/^ignore/", "string-ignore"]

The following comments are not considered problems:

:root {  background: pink;  /* ignore this comment because of the regex */  color: pink;}
:root {  background: pink;  /* string-ignore */  color: pink;}