Answers, step-by-step guides, and tips.
Setting Up Custom Data Filters
Content Focus: Technical instructions for IT/Admins on how to push custom metadata (like Shift Groups or Locations) into the analytics engine.

1. Introduction

You are no longer limited to the standard filters (like Accounting group or Contract type). You can now create your own Custom Filters in the Analytics dashboard based on any data field you track for your employees (e.g., Shift Group, Location, Seniority Level).


Note: You’ll find the grape Connect Stoplight documentation for the metadata field here.

2. How it works

This feature works automatically based on the data you send us. There is no manual setup in the platform.

  1. Prepare the Data Ask your IT team or Integration Partner to include specific "Metadata" fields in the employee data they sync with us.
  2. The Logic You need to send two values:
    • kind: This becomes the Name of the Filter (e.g., "Cost Center").
    • value: This becomes the Option in the filter (e.g., "CC-102").
  3. The Result As soon as we receive this data, a new dropdown filter with that name will automatically appear on your Analytics Dashboard.

Example Configuration

If your IT team sends this data for your employees:

kind: "Seniority Level"
value: "Junior"


You will instantly see a filter called "Seniority Level" in the analytics view, and you can select "Junior" to view absences for all employees in that group.

3. Handling Multiple Values

If an employee belongs to multiple categories for the same attribute (e.g., they work in both Location A and Location B), simply send the attribute twice for that employee:

  • Entry 1: kind: "Location", value: "A"
  • Entry 2: kind: "Location", value: "B"


Important: Do not send a list or array of values in a single entry.

4. Filtering Logic (AND vs. OR)

It is important to understand how the filters interact:

  • Within the same filter (OR Logic) If you select multiple options in one dropdown (e.g., "Location"), we show results that match any of them.
    • Example: Selecting "Zurich" and “Basel" shows employees from Zurich OR Basel.
  • Across different filters (AND Logic) If you combine two different filters, we show results that match both criteria.
    • Example: Selecting Location “Zurich” and “Basel" AND Seniority “Senior" will show employees who are in (Zurich OR Basel) AND are also Senior.

Pro Tip: Check Standard Filters First

To keep your dashboard clean, please do not create custom filters for data fields that grape already provides natively. If you add these as custom metadata, you will end up with duplicate filters on your dashboard.

Did this answer you question?