Manage Spaces with Custom Tags

Overview

Butlr’s space tagging feature allows users to create and apply descriptive labels (tags) to floors, rooms, and zones. These tags enable more efficient organization, filtering, and analysis across space types (e.g., “office,” “residential,” “meeting room”).

Tags can be managed through the Butlr web interface or programmatically via the GraphQL API, making it scalable for both manual and automated workflows.

What You Can Do With Tags

• Categorize spaces by function (e.g., “office,” “lobby,” “retail”).
• Filter occupancy data by tag.
• Compare performance of similar space types.

• Automate tag assignment at scale via API.

   

Tagging via the Butlr Web Interface

➕ Adding a Tag to a Room or Zone

1. Navigate to a space (e.g., “Agent Hesterman”) in the Historical or Live view.
2. Click + Add Tag next to the space name, or in Studio, click on the space on the floor plan, and assign tag in the space setting panel.

⚙️ Tag Management (Admin Panel)

1. Go to Settings → Tags.
2. Create new tags by entering a name and clicking Submit.
3. Edit or delete tags and view their associations with floors, rooms, and zones.
4. Bulk associate tags with multiple areas for streamlined management.

📊 Tag-Based Filtering & Comparison

On the Historical view, you can filter by one or more tags (e.g., workstation) to compare performance across similarly tagged rooms.

• The Occupancy by Selection graph updates to show only tagged rooms.

• Below the graph, you'll see key metrics like:

  • Avg. Occupancy

  • Utilization Rates

  • Peak Usage

  • Time Used

This makes it easy to answer: "Which workstations were most utilized yesterday?"

Tagging via API

The Butlr GraphQL API allows you to programmatically manage tags, ideal for system integrators, facility teams, or enterprise IT.

🔗 API Docs: Butlr Asset Tags API

Best Practices

• Keep tags consistent across floors/buildings.
• Use plural or category-based naming (e.g., "labs," "shared workspaces").
• Clean up unused or outdated tags periodically.
• Integrate tagging into onboarding flows for new assets.

Need Help?

For help with tag strategy, API integration, or analytics setup, contact your Butlr Customer Success Manager or visit our Developer Docs.