Selectors provide a powerful, friendly way to slice through maps, based on Cascading Style Sheets (CSS) selectors.
If you're familiar with CSS, you'll feel right at home. If you haven't seen or used CSS, don't worry! All the selector patterns you'll ever need are documented in this reference. To see examples of how selectors can be used, check out our general guide on selectors.
There are two reference tables on this page. The first shows you all the different kinds of selectors you can use in Kumu, and the second table gives details about logical operators that can be used inside of certain selectors.
In the first table, you'll notice that the word "slug" appears a lot. A slug is a piece of text that has had all letters converted to lowercase, all special characters removed, and all spaces and replaced with hyphens. So, when you see something like
type-slug in the table below, this will be replaced in your custom selector with something like
individual or another "slug" version of an element type.
|Selector||What it selects|
|All elements, connections, and loops|
|All elements whose element type slug matches
|All connections whose connection type slug matches
|The item whose label slug matches
|The item whose assigned ID slug matches
|The item whose system ID matches
|All items whose Tags field contains
|All items that have a field name and field value that meet the condition of the
|All items that have any value in the field whose name matches
|All items that have no value in the field whose name matches
|All items that have any value in the field whose name slug matches
|All items that have no value in the field whose name slug matches
|All connections coming from an item that matches the
|All connections going to an item that matches the
|All directed connections|
|All undirected connections|
|All mutual connections|
|All items at the root of a focus setting|
|All items that do not match the
|is equal to|
|is not equal to|
|list of values includes (this operator matches full values)|
|is greater than|
|is less than|
|is greater than or equal to|
|is less than or equal to|