This is a cache of https://www.elastic.co/guide/en/elasticsearch/painless/8.19/painless-comments.html. It is a snapshot of the page as it appeared on 2025-11-22T03:20:55.446+0000.
Comments | Painless Scripting Language [8.<strong>19</strong>] | Elastic
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Comments

edit

Use a comment to annotate or explain code within a script. Use the // token anywhere on a line to specify a single-line comment. All characters from the // token to the end of the line are ignored. Use an opening /* token and a closing */ token to specify a multi-line comment. Multi-line comments can start anywhere on a line, and all characters in between the /* token and */ token are ignored. A comment is included anywhere within a script.

Grammar

SINGLE_LINE_COMMENT: '//' .*? [\n\r];
MULTI_LINE_COMMENT: '/*' .*? '*/';

Examples

  • Single-line comments.

    // single-line comment
    
    int value; // single-line comment
  • Multi-line comments.

    /* multi-
       line
       comment */
    
    int value; /* multi-
                  line
                  comment */ value = 0;
    
    int value; /* multi-line
                  comment */
    
    /* multi-line
       comment */ int value;
    
    int value; /* multi-line
                  comment */ value = 0;
    
    int value; /* multi-line comment */ value = 0;