Location Mapping Rules

Location mapping rules tell Pult how to assign WiFi clients to presence locations. Each rule defines conditions (IP subnet, and optionally access point labels) that, when matched, attribute the WiFi activity to a specific location.

How Mapping Rules Work

When Pult receives WiFi client data during a sync, it evaluates each client against the configured rules:

1. Subnet matching: The client's IP address is checked against the subnet(s) defined in each rule. This is the primary matching criterion.
2. Label matching (optional): If the rule includes access point labels, the client's connected access point must also match the label conditions.
3. Priority: When multiple rules match, the rule with the highest priority wins.

If a client matches a rule, its activity is attributed to the rule's target presence location.

Configuring Rules

Navigate to Settings → Presence → General Settings in the Pult Dashboard. The Location Mappings section lets you create and manage rules.

Each rule has:

Subnet Conditions

Every rule must include at least one IPv4 subnet (in CIDR notation, e.g., 10.0.1.0/24). The WiFi client's IP address must fall within one of the specified subnets for the rule to match.

Access Point Label Conditions

Optionally, you can refine rules using access point labels -- tags assigned to your WiFi access points during the AP sync. Two types of label conditions are available:

• Strong labels (AND logic): All specified labels must be present on the access point. Use this when you need to match APs that belong to a specific combination of categories.
• Weak labels (OR logic): At least one of the specified labels must be present. Use this for broader matching across multiple AP groups.

Priority

When a WiFi client matches multiple rules, the rule with the higher priority value takes precedence. Use priority to handle overlapping subnets or to define fallback rules.

Common Patterns

Simple subnet-per-location

The most common setup. Each presence location has a distinct subnet range:

• Rule 1: Subnet 10.0.1.0/24 → "Hamburg HQ"
• Rule 2: Subnet 10.0.2.0/24 → "Berlin Office"
• Rule 3: Subnet 10.0.3.0/24 → "Munich Office"

Same subnet, different floors

When multiple locations share a subnet but have different access points:

• Rule 1: Subnet 10.0.0.0/16 + Label "Floor 1" → "Hamburg -- Floor 1"
• Rule 2: Subnet 10.0.0.0/16 + Label "Floor 2" → "Hamburg -- Floor 2"

Fallback rule

A broad rule with low priority to catch unmatched clients:

• Rule 1 (priority 10): Subnet 10.0.1.0/24 → "Hamburg -- Main"
• Rule 2 (priority 1): Subnet 10.0.0.0/8 → "Hamburg -- General" (catches remaining)

Access Point Labels

Labels are synced automatically from your WiFi controller during the AP sync. They represent the grouping structure in your WiFi management system (e.g., sites, groups, or custom tags).

You can view available labels in Settings → Presence → General Settings under the label management section.