diff --git a/docs/pages/guides/recipes/access-control/controlling-access-to-cubes-and-views.mdx b/docs/pages/guides/recipes/access-control/controlling-access-to-cubes-and-views.mdx
index 91514035d9777..f8b9421af50d6 100644
--- a/docs/pages/guides/recipes/access-control/controlling-access-to-cubes-and-views.mdx
+++ b/docs/pages/guides/recipes/access-control/controlling-access-to-cubes-and-views.mdx
@@ -52,9 +52,15 @@ cubes:
views:
- name: total_revenue_per_customer
public: {{ COMPILE_CONTEXT['securityContext']['isFinance'] }}
- includes:
- - orders.total_revenue
- - users.company
+
+ cubes:
+ - join_path: orders
+ includes:
+ - total_revenue
+
+ - join_path: orders.users
+ includes:
+ - company
```
```javascript
@@ -75,12 +81,25 @@ cube(`users`, {
});
// total_revenue_per_customer.js
-view("total_revenue_per_customer", {
+view(`total_revenue_per_customer`, {
description: `Total revenue per customer`,
public: COMPILE_CONTEXT.securityContext.isFinance,
- includes: [orders.total_revenue, users.company],
-});
+ cubes: [
+ {
+ join_path: orders,
+ includes: [
+ `total_revenue`
+ ]
+ },
+ {
+ join_path: orders.users,
+ includes: [
+ `company`
+ ]
+ }
+ ]
+})
```
diff --git a/docs/pages/reference/data-model/view.mdx b/docs/pages/reference/data-model/view.mdx
index fe7bb50f74b45..82472bc5322da 100644
--- a/docs/pages/reference/data-model/view.mdx
+++ b/docs/pages/reference/data-model/view.mdx
@@ -292,8 +292,20 @@ view(`arr`, {
description: `Annual Recurring Revenue`,
public: COMPILE_CONTEXT.security_context.is_finance,
- includes: [revenue.arr, revenue.date, customers.plan],
-});
+ cubes: [
+ {
+ join_path: revenue,
+ includes: [
+ `arr`,
+ `date`
+ ]
+ },
+ {
+ join_path: revenue.customers,
+ includes: `plan`
+ }
+ ]
+})
```
```yaml
@@ -302,12 +314,15 @@ views:
description: Annual Recurring Revenue
public: COMPILE_CONTEXT.security_context.is_finance
- includes:
- # Measures
- - revenue.arr
- # Dimensions
- - revenue.date
- - customers.plan
+ cubes:
+ - join_path: revenue
+ includes:
+ - arr
+ - date
+
+ - join_path: revenue.customers
+ includes:
+ - plan
```
@@ -344,50 +359,6 @@ views:
The `access_policy` parameter is used to configure [data access policies][ref-ref-dap].
-### `includes` (deprecated)
-
-
-
-The top-level `includes` parameter is deprecated and might be removed in
-the future. Please always use the `includes` parameter with `cubes` and
-`join_path` parameters so you can explicitly control the join path.
-
-
-
-The top-level `includes` parameter is used to bulk add measures or dimensions
-to a view.
-
-
-
-```javascript
-view(`active_users`, {
- includes: [
- // Measures
- users.rolling_count,
-
- // Dimensions
- users.city,
- users.created_at,
- ],
-});
-```
-
-```yaml
-views:
- - name: active_users
-
- includes:
- # Measures
- - users.rolling_count
-
- # Dimensions
- - users.city
- - users.created_at
-```
-
-
-
-
[ref-recipe-control-access-cubes-views]:
/guides/recipes/access-control/controlling-access-to-cubes-and-views
[ref-schema-joins-direction]: