Using Special Characters in CloudBees Flow Object Names

You should avoid using the following special characters when naming objects in CloudBees Flow. These characters have special purposes or meanings within CloudBees Flow or in the scripting language being used.

However, if any of these characters are used in object names, then your implementation must correctly escape them at runtime (meaning in context of the scripting language, such as JavaScript, Groovy, or Perl) to avoid errors or unexpected behavior.

Character Description

Used for absolute property paths in CloudBees Flow. The path syntax is similar to a file system path specification.

[] or .

Used in JavaScript.


Might cause problems when used in job names. Some operating systems do not allow directories containing this character.


Used for escaping.

(space) or '

Should be enclosed in quotes when used in ectool or JavaScript. Otherwise, it should be escaped properly. Also, spaces might cause issues when used in resource pool names and should be avoided.

, or ;

Might cause issues when used in user names (such as in a list of approvers).

Copyright © 2010-2020 CloudBees, Inc.Online version published by CloudBees, Inc. under the Creative Commons Attribution-ShareAlike 4.0 license.CloudBees and CloudBees DevOptics are registered trademarks and CloudBees Core, CloudBees Flow, CloudBees Flow Deploy, CloudBees Flow DevOps Insight, CloudBees Flow DevOps Foresight, CloudBees Flow Release, CloudBees Accelerator, CloudBees Accelerator ElectricInsight, CloudBees Accelerator Electric Make, CloudBees CodeShip, CloudBees Jenkins Enterprise, CloudBees Jenkins Platform, CloudBees Jenkins Operations Center, and DEV@cloud are trademarks of CloudBees, Inc. Most CloudBees products are commonly referred to by their short names — Accelerator, Automation Platform, Flow, Deploy, Foresight, Release, Insight, and eMake — throughout various types of CloudBees product-specific documentation. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Jenkins is a registered trademark of the non-profit Software in the Public Interest organization. Used with permission. See here for more info about the Jenkins project. The registered trademark Jenkins® is used pursuant to a sublicense from the Jenkins project and Software in the Public Interest, Inc. Read more at Apache, Apache Ant, Apache Maven, Ant and Maven are trademarks of The Apache Software Foundation. Used with permission. No endorsement by The Apache Software Foundation is implied by the use of these marks.Other names may be trademarks of their respective owners. Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this content, and CloudBees was aware of a trademark claim, the designations have been printed in caps or initial caps. While every precaution has been taken in the preparation of this content, the publisher and authors assume no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.