diff --git a/content/developer/reference/user_interface/view_architectures.rst b/content/developer/reference/user_interface/view_architectures.rst
index 3225a265d..03b1a306a 100644
--- a/content/developer/reference/user_interface/view_architectures.rst
+++ b/content/developer/reference/user_interface/view_architectures.rst
@@ -1917,28 +1917,121 @@ The `filter` element can have the following attributes:
+ By default, these filters contain a dropdown with different sub-filters that allow you to filter based on months, quarters and years.
+ Additionally, you can create custom sub-filters that allow filtering using domains.
+ These custom filters must have the following attributes: `name`, `string` and `domain`.
+
+ .. example::
+ .. code-block:: xml
+
+
+
+
+
+ Note that all custom filters defined this way are mutually exclusive with each other and with the other sub-filters.
+
:requirement: Optional
:type: str
:default: `''`
+.. attribute:: start_month
+ :noindex:
+
+ The earliest month that will show up in the dropdown of a date filter, as an offset relative to the current month.
+
+ .. example::
+ .. code-block:: xml
+
+
+
+ If the current month is February, the earliest month selectable in the dropdown will be November.
+
+ :requirement: Optional
+ :type: int
+ :default: `-2`
+ :scope: Filters with a non-empty `date` attribute
+
+.. attribute:: end_month
+ :noindex:
+
+ The latest month that will show up in the dropdown of a date filter, as an offset relative to the current month.
+
+ .. example::
+ .. code-block:: xml
+
+
+
+ If the current month is February, the latest month selectable in the dropdown will be March.
+
+ :requirement: Optional
+ :type: int
+ :default: `0`
+ :scope: Filters with a non-empty `date` attribute
+
+.. attribute:: start_year
+ :noindex:
+
+ The earliest year that will show up in the dropdown of a date filter, as an offset relative to the current year.
+
+ .. example::
+ .. code-block:: xml
+
+
+
+ If the current year is 2024, the earliest year selectable in the dropdown will be 2021.
+
+ :requirement: Optional
+ :type: int
+ :default: `-2`
+ :scope: Filters with a non-empty `date` attribute
+
+.. attribute:: end_year
+ :noindex:
+
+ The latest year that will show up in the dropdown of a date filter, as an offset relative to the current year.
+
+ .. example::
+ .. code-block:: xml
+
+
+
+ If the current year is 2024, the latest year selectable in the dropdown will be 2025.
+
+ :requirement: Optional
+ :type: int
+ :default: `0`
+ :scope: Filters with a non-empty `date` attribute
+
.. attribute:: default_period
:noindex:
The default period of the time-based filter (with a `date` attribute). It must be one of, or a
- comma-separated list of, `today`, `this_week`, `this_month`, `last_month`,
- `antepenultimate_month`, `fourth_quarter`, `third_quarter`, `second_quarter`, `first_quarter`,
- `this_year`, `last_year` or `antepenultimate_year`.
+ comma-separated list of valid filter ids.
+
+ Valid filter ids include the following:
+
+ - `first_quarter`, `second_quarter`, `third_quarter` and `fourth_quarter`.
+ - One of `month`, `month-x` and `month+x`, where `x` is a non-zero integer value between `start_month` and `end_month`.
+ - One of `year`, `year-x` and `year+x`, where `x` is a non-zero integer value between `start_year` and `end_year`.
+ - The `name` of any custom filter defined within the filter, prepended with `custom_`.
The filter must be in the default set of filters activated at the view initialization.
.. example::
.. code-block:: xml
-
+
+
+ .. example::
+ .. code-block:: xml
+
+
+
+
:requirement: Optional
:type: str
- :default: `this_month`
+ :default: `month`, or the closest value to the current month if unavailable
:scope: Filters with a non-empty `date` attribute
.. include:: view_architectures/generic_attribute_invisible.rst