---
title: "Filtering by Field"
canonical: "https://networkconnect.docs.rubiconwater.com/space/NC/2503443126/Filtering%20by%20Field"
format: markdown
---
> Macro (toc)

Filter by field by creating an expression using tag or attribute values.

> ℹ️ **Note**
> ℹ️ 
> ℹ️ Note that for tags this filter is currently only available for numeric values (this restriction does not apply to attributes).

# Create a Simple Expression with no Groups

To create a field filter, open the Field option in the filter pane. Conditions are organized in groups (although a group can contain only one condition).

**Step 1**

Click the **And** or the** Or** button. This sets the relationship between the conditions in the current group. 

> ℹ️ **Example**
> ℹ️ 
> ℹ️ If you click **Or** to begin a group and add three conditions the expression for that group will be:
> ℹ️ 
> ℹ️ *(condition1 OR condition2 OR condition3)*

**Step 2**

Click the **+** button to either:

- Add a new condition to the current group.
- Create a new group. (If you are starting a new group don’t forget to choose whether it will be an And group or an Or group).

**Step 3**

To create a new condition, start entering the **tag name**, the** tag description**, or the **attribute name** into the first field. The drop-down will be populated with matching tags or attributes. You can hover over any of the items to see more details of that tag or attribute.

In this example we will create an expression for the current flow tag. 

> ℹ️ **Note**
> ℹ️ 
> ℹ️ This field is not case-sensitive.

We want to use the tag with a tag description of *Current Flow* and a tag name of *FLOW_VAL.*

> ℹ️ **Important**
> ℹ️ 
> ℹ️ If you are using a tag you may find that there is more than one match because the same tag name may have different tag descriptions. For example, the CTRL_MODE tag is used for the Control Mode at regulators and for the Irrigation Mode at outlets. 
> ℹ️ 
> ℹ️ **You must match the both the tag name and the tag description for any tag you want to use in your expression.**

**Step 4**

Now that we have added the tag name we can complete the condition by adding an operator and a value. The expression below filters for sites with current flow that is greater than 2 (in whatever flow units you are using).

# Add Groups to an Expression

You can create more complex expressions by adding groups of conditions. To add a new group, choose the operator (**And** or **Or**) and choose **Add Group**. When you create a group, a new set of group controls appears at the top of the group.

You can add a group at any level by adding it from the appropriate set of controls.

### Example

The following expression can be expressed as:

*Current Flow <= 2 OR ((U/S Level < 8 OR Current Flow > 2) AND D/S Water level > 2)*

---