diff --git a/docs/custom-props/props-dashboard.md b/docs/custom-props/props-dashboard.md
index 1c1745fd..a07624c1 100644
--- a/docs/custom-props/props-dashboard.md
+++ b/docs/custom-props/props-dashboard.md
@@ -29,7 +29,7 @@ You can also open [the filter dropdown menu](filters-segments.md) in the top rig
In that view you can interact with the dropdown fields, where Plausible will automatically provide filtering suggestions based on the custom properties that we have recorded. The suggestions take into account the selected time period and other filters that you've already applied to your stats. You can choose between "is", "is not", "does not contain" and "contains" as options when selecting the custom property to filter by.
-You can filter by multiple custom properties too. Click on the **Add another** link to add another custom property to the filter. Choose the custom properties that you want to segment your audience by and click on the **Apply Filter** button to filter your dashboard.
+You can filter by multiple custom properties too. Click on the **Add filter** option ("+" icon) to add another custom property to the filter. Choose the custom properties that you want to segment your audience by and click the **Done** button to filter your dashboard.
})
diff --git a/docs/filters-segments.md b/docs/filters-segments.md
index 80a89dbe..542fe8c1 100644
--- a/docs/filters-segments.md
+++ b/docs/filters-segments.md
@@ -20,9 +20,9 @@ Any metric you click on in your dashboard creates a new filter. Click on any ref
You can mix and match filters too. So you can click on a referral source, then click on a country and then a goal to see all the traffic sent by the chosen referral source that is based in the selected country and that has converted on the selected goal.
-Your current filters will be displayed on the top of your dashboard. You can click on the name of the existing filter to edit it or on the `x` icon to remove it.
+Your current filters appear as pills at the top of your dashboard. Each pill shows the dimension, operator and selected values. Click the operator or values to edit that part of the filter. Your changes apply immediately. Click the `x` icon to remove the filter.
-You can remove all your filters by hitting the `Esc` key on your keyboard or by selecting **Clear all filters** in the filters menu (`***`).
+You can remove all your filters by hitting the `Esc` key on your keyboard or by clicking the **bin** icon next to the filter pills.
## Use the "Filter" button for more powerful segmenting and matching
@@ -30,7 +30,11 @@ You can remove all your filters by hitting the `Esc` key on your keyboard or by
-When you’re trying to understand and analyze your traffic, the **Filter** button is a powerful tool. It allows you to search, select multiple entries and it includes options "is", "is not", "contains" and "does not contain" to give you more flexibility when matching and segmenting your audience. Click on the **Filter** button on the top right of your dashboard to start adding filters.
+When you’re trying to understand and analyze your traffic, the **Filter** button gives you more control. Click it and choose a dimension such as **Page**, **Source**, **Location** or **Goal**. Some dimensions are grouped in submenus. For example, **Page** contains **Page**, **Entry page** and **Exit page**.
+
+Choosing a dimension adds a filter pill and opens its value list. Search for a value or select multiple values from the list. Changes apply immediately, so there is no separate apply step. Click **Done** or click outside the list when you are finished.
+
+To change how values are matched, click the operator in the filter pill. Depending on the dimension, you can choose "is", "is not", "contains" or "does not contain".
### Filter by multiple sources, countries, pages and more
@@ -48,7 +52,7 @@ You can search for any metric such as a particular country, referral source or p
You can exclude specific segments of traffic and only display the traffic that isn't part of the excluded segment. You can, for instance, exclude traffic from the United States so your dashboard only shows the visitors that aren't based in the USA.
-Click on the **Filter** button, then select **Country** as your metric, choose "is not" (or "does not contain" as an alternative) and then select (or type) the name of the country you want to exclude. You can do the same for referral sources or any of the other metrics.
+Click on the **Filter** button, open **Location** and select **Country**. Then select or type the name of the countries you want to exclude. Click the operator in the filter pill and choose "is not" or "does not contain." You can do the same for referral sources or any of the other dimensions.
### Group relevant pages, marketing campaigns and more
@@ -70,7 +74,7 @@ Learn more on how Plausible [handles cross-subdomain tracking here](subdomain-ho
## How to save a segment
-Click on any metric in the dashboard or use the **Filter** button to filter your audience to a desired segment. After completing your segment, click on the **Save as segment** button that is visible in the filters menu (`***`) that you see when your dashboard is filtered.
+Click on any metric in the dashboard or use the **Filter** button to filter your audience to a desired segment. After completing your segment, click the **Save as segment** (star icon) option next to the filter pills.