diff --git a/pages/changelogs/2024-03-11-sub-to-boards.mdx b/pages/changelogs/2024-03-11-sub-to-boards.mdx
index 79ff57bac0..ee733b1c75 100644
--- a/pages/changelogs/2024-03-11-sub-to-boards.mdx
+++ b/pages/changelogs/2024-03-11-sub-to-boards.mdx
@@ -9,7 +9,7 @@ thumbnail: "/changelog/subscribetoboards.png"
---
Boards are a useful tool to collect a series of reports in one place, but they shouldn't be a set and forget experience. It's important to stay in the loop with how these key metrics are moving.
-To keep you and your team up to date on how much progress you're making towards your metrics, you can [Subscribe to a Board](/docs/boards/advanced#board-subscriptions).
+To keep you and your team up to date on how much progress you're making towards your metrics, you can [Subscribe to a Board](/docs/boards#board-subscriptions).
All it takes is setting the schedule of how often you want to receive this information and selecting where you want to read it (email or Slack).
Teams that are collectively informed on their data can stay on the same page, and using Subscribe to Boards can help them get there.
diff --git a/pages/docs/boards.mdx b/pages/docs/boards.mdx
index 852484bad9..5da11d7680 100644
--- a/pages/docs/boards.mdx
+++ b/pages/docs/boards.mdx
@@ -54,7 +54,7 @@ There are a few ways to add an existing report to a board. You can either start
- Starting from an existing report, adding the report to a board can be done via the board breadcrumb dropdown at the top left of the report, next to the report's title. Click into the dropdown, then select "Add to another Board." Choose your board, and a copy of the report will be added to it.
- Starting from another board, select the overflow menu of a report you'd like to add. Select "Make a Copy" and then choose the board you would like to add it to.
-Note that adding an existing report always creates a [linked copy](/docs/boards/advanced#what-is-a-linked-report).
+Note that adding an existing report always creates a [linked copy](/docs/boards/sharing-and-permission#linked-reports).
Text cards support rich text formatting. After highlighting the text in a text card, you'll see a menu pop up where you can apply the following:
@@ -114,3 +114,52 @@ Row heights can now be adjusted to either show more report content, or hide empt
A row's height is initially determined by the tallest card within that row. Text cards can be very short if they contain only one line of text, or very tall if they contain many lines. Meanwhile, reports always start at their minimum height, but may warrant expansion in order to show more data (more bars on a bar chart, for example).
A row will start life at the minimum possible height.
+
+### Step 5: Board-wide Date Ranges and Filters
+
+Boards allow you to alter some aspects of the queries within each of the reports on that board, making it simple to ensure every report is showing results from a consistent set of data. Both date ranges and filters can be added by clicking "Add Filter" at the top right of the board. This will open a row, shown below, where the date range can be selected, and filters can be applied.
+
+![/Screen_Shot_2022-01-07_at_2.35.49_PM.png](/Screen_Shot_2022-01-07_at_2.35.49_PM.png)
+
+By default, date ranges and filters are temporary, allowing you to explore the data without overwriting the board. But, if you wish to save the date range and filter selections you've made to the board, so they'll appear for other users as well, click "Save to Board."
+
+**Note** Applying date ranges and filters on a board does not change the queries saved in each individual report; instead, it only changes the data displayed when you view those reports in the current board. If you click into a report from the board, however, Mixpanel will maintain the date range and filters to ensure you see data consistent between the board and report. Navigate to the report on its own, though, and you'll see the report's original saved date range and filters.
+
+
+## Board Subscriptions
+
+Board Subscriptions allow you to receive a snapshot of a board sent as an email or a slack message. Subscriptions allow members to share recent data with both project members and external audiences, providing quick and meaningful insight into a Mixpanel project.
+
+You must be a Project Owner, Admin, or Analyst to create a subscription.
+
+Subscriptions will send the board on a recurring schedule. You can choose a daily, weekly or monthly interval. Note that subscriptions only show the 8 reports that are on the top of a board.
+
+To create a Subscription:
+
+1. Select **Subscribe** from the header at the top right of the board. You can see a list of existing subscriptions for the board here as well. Select "Create New".
+ ![/subscribe1.png](/subscribe1.png)
+
+2. Fill out the resulting form, selecting the desired email recipients or Slack channel, as well as the sending frequency (daily, weekly, or monthly).
+ ![/subscribe2.png](/subscribe2.png)
+ - Any email address will receive the email, whether or not they are internal or external to your organization
+ - Private Slack Channels are not available at this time
+3. Click "Subscribe".
+
+### Seeing All Subscriptions
+![/subscribe3.png](/subscribe3.png)
+
+You can access this by clicking the "Subscribe" button at the top right of the board. Then select "View All".
+This gives you a view of all subscriptions across all users.
+
+### Subscriptions for Private Boards
+
+It is possible to subscribe to a private board. However, there are some restrictions to what will be visible or accessible.
+
+1. If you convert a regular board with subscriptions into a private board, existing subscriptions will still work with existing recipients. However, if they click **View Board**, they will not be able to access your private board. Creating new subscriptions or editing existing subscriptions within the private board will force you to limit recipients to yourself.
+2. You cannot edit subscriptions of someone else’s private board without selecting a different board that you have access to (regardless of your permissions or role). You can still delete the subscription or select a different board.
+
+## TV Mode
+
+The **Enter TV Mode** option enables displaying a Board on a big screen (such as a TV in the office) where top-level company metrics / KPIs can be constantly monitored. The Board will auto-refresh every 10 minutes when in TV mode.
+
+![image](/boards-tv-mode.png "Enter TV Mode")
\ No newline at end of file
diff --git a/pages/docs/boards/_meta.ts b/pages/docs/boards/_meta.ts
index 31fe195a20..125544e50d 100644
--- a/pages/docs/boards/_meta.ts
+++ b/pages/docs/boards/_meta.ts
@@ -1,6 +1,7 @@
export default {
+ "sharing-and-permission": "Sharing and Permission",
"templates": "Templates",
"boards-on-boards": "Boards on Boards",
"public-boards": "Public Boards",
- "advanced": "Advanced"
+ "move-boards": "Move Boards"
}
diff --git a/pages/docs/boards/advanced.mdx b/pages/docs/boards/advanced.mdx
deleted file mode 100644
index f30eb98428..0000000000
--- a/pages/docs/boards/advanced.mdx
+++ /dev/null
@@ -1,202 +0,0 @@
-import { Callout } from 'nextra/components'
-
-# Advanced
-
-## Board-wide Date Ranges and Filters
-
-Boards allow you to alter some aspects of the queries within each of the reports on that board, making it simple to ensure every report is showing results from a consistent set of data. All board-wide settings can be accessed from the top of the screen, right below the header. Select the desired date range on the left side, or select a filter by pressing the "+" button on the right side. By default, board-wide date ranges and filters are temporary. If you wish to save the date range and filter selections you've made to the board, so they'll appear for all users, click "Save", to the right of the filters. Similarly, you can press "Cancel" to discard the changes.
-
-![board filters](/board-filters.png)
-
-Applying date ranges and filters on a board does not change the queries saved in each individual report; instead, it only changes the data displayed when you view those reports in the current board. If you click into a report from the board, however, Mixpanel will maintain the date range and filters to ensure you see data consistent between the board and report. Navigate to the report on its own, though, and you'll see the report's original saved date range and filters.
-
-Board-wide settings are also not modifiable in the report. Since the board-wide settings are always applied, we maintain them so they don't affect report state and to keep consistent results once a user navigates back to the board.
-
-### Board-wide Date Ranges
-
-By default, the board respects the date range selected by each individual report. You can set a date range board-wide. All date range settings are the same as in reports, so any date range you select in boards will be the same as if it were selected in a report.
-
-### Board-wide Filters
-
-Press the plus button to add a filter. Filters are applied to every report in the board. Note that the filters set from the board could conflict with filters on individual reports, leading to unexpected results. All board-wide filters are added to the "Filter" section in reports
-
-#### Board-wide Filter Settings
-
-![board filter settings](/board-filter-settings.png)
-
-Filter Settings are only available for enterprise plans.
-
-Filter settings allow for additional configuration on boards, meant for boards that are highly consumed or are standardized across a set of filters. Filter settings are only available for string filters using "is" or "is not" operators.
-
-- "Limit filter values to the selection above"
- Reduces the set of values available when accessing the filter to the choices selected. This is useful when there are a large set of filter values, and the board creator wants to focus in only on a certain set of filter values
-
-- "Start filter with nothing selected"
- Starts the filter as not filtering for anything. This is useful when the filter property is known, or when wanting to focus to a particular property. This also saves time from users from having to select this property.
-
-These settings can be used in combination, so that a filter property can be selected, and only be allowed to choose a particular subset of values.
-
-## Board Subscriptions
-
-Board Subscriptions allow you to receive a snapshot of a board sent as an email or a slack message. Subscriptions allow members to share recent data with both project members and external audiences, providing quick and meaningful insight into a Mixpanel project.
-
-You must be a Project Owner, Admin, or Analyst to create a subscription.
-
-Subscriptions will send the board on a recurring schedule. You can choose a daily, weekly or monthly interval. Note that subscriptions only show the 8 reports that are on the top of a board.
-
-To create a Subscription:
-
-1. Select **Subscribe** from the header at the top right of the board. You can see a list of existing subscriptions for the board here as well. Select "Create New".
- ![/subscribe1.png](/subscribe1.png)
-
-2. Fill out the resulting form, selecting the desired email recipients or Slack channel, as well as the sending frequency (daily, weekly, or monthly).
- ![/subscribe2.png](/subscribe2.png)
- - Any email address will receive the email, whether or not they are internal or external to your organization
- - Private Slack Channels are not available at this time
-3. Click "Subscribe".
-
-### Seeing All Subscriptions
-![/subscribe3.png](/subscribe3.png)
-
-You can access this by clicking the "Subscribe" button at the top right of the board. Then select "View All".
-This gives you a view of all subscriptions across all users.
-
-### Subscriptions for Private Boards
-
-It is possible to subscribe to a private board. However, there are some restrictions to what will be visible or accessible.
-
-1. If you convert a regular board with subscriptions into a private board, existing subscriptions will still work with existing recipients. However, if they click **View Board**, they will not be able to access your private board. Creating new subscriptions or editing existing subscriptions within the private board will force you to limit recipients to yourself.
-2. You cannot edit subscriptions of someone else’s private board without selecting a different board that you have access to (regardless of your permissions or role). You can still delete the subscription or select a different board.
-
-## Sharing and Permissions
-
-
-4. Lexicon
+1. Lexicon
Schemas API or CSV Export/Import: Migrate the Lexicon schema definitions (i.e. display name, descriptions, etc.) of your events, event properties, and user properties from the existing project to the new project using either the [Lexicon Schemas API](https://developer.mixpanel.com/reference/lexicon-schemas-api) or [Lexicon CSV Export/Import](/docs/data-governance/lexicon#export-and-import-lexicon-data).
diff --git a/pages/docs/users.md b/pages/docs/users.mdx
similarity index 64%
rename from pages/docs/users.md
rename to pages/docs/users.mdx
index 4c1b642c0e..b0a9d3b652 100644
--- a/pages/docs/users.md
+++ b/pages/docs/users.mdx
@@ -8,7 +8,7 @@ If you want to import User Profiles into Mixpanel, see our [User Profiles guide]
### Use Case
-Mixpanel’s Users page aggregates and organizes a collection of user profiles. This facilitates a granular view into the behavior of individual users or groups of users. The Users page can be used to:
+Mixpanel's Users page aggregates and organizes a collection of user profiles. This facilitates a granular view into the behavior of individual users or groups of users. The Users page can be used to:
- Count users based on behavior.
- Explore their unique history.
@@ -17,17 +17,17 @@ Mixpanel’s Users page aggregates and organizes a collection of user profiles.
## Basic Features
-You can select **User Profiles** or **All Users** in the Users page. If you select **User Profiles**, the page will only show users that have at least one user profile property set. If you select **All Users**, the page will show all users who have completed any event.
+You can select **User Profiles** or **All Users** in the Users page. If you select **User Profiles**, the page will only show users that have at least one user profile property set. If you select **All Users**, the page will show all users who have completed any event.
![/Screen_Shot_2022-07-12_at_11.55.17_AM.png](/Screen_Shot_2022-07-12_at_11.55.17_AM.png)
-By clicking the name of a user in the User tables, you can explore that user's unique history by examining their user profile. Learn more about the Users Profiles [here](/docs/data-structure/user-profiles).
+By clicking the name of a user in the User tables, you can explore that user's unique history by examining their user profile. Learn more about the Users Profiles [here](/docs/data-structure/user-profiles).
### Cohorts
A cohort is a group of users who share a certain set of properties or have performed a particular combination or frequency of events. You can create a cohort on the Users page by generating filtering criteria. Once a cohort is created, you can save it and use it to group and filter data in other Mixpanel reports.
-Learn more about Cohorts [here](/docs/users/cohorts).
+Learn more about Cohorts [here](/docs/users/cohorts).
@@ -35,7 +35,7 @@ Learn more about Cohorts [here](/docs/users/cohorts). ### Modifying Table Columns -You may wish to change what data is displayed in the Users table. You can do so by clicking on **Edit Columns** and selecting / deselecting the profile properties you wish to display on the User table +You may wish to change what data is displayed in the Users table. You can do so by clicking on **Edit Columns** and selecting / deselecting the profile properties you wish to display on the User table ![/Screen_Shot_2022-07-12_at_2.22.57_PM.png](/Screen_Shot_2022-07-12_at_2.22.57_PM.png) @@ -44,12 +44,12 @@ You may wish to change what data is displayed in the Users table. You can do so ### How do I create a cohort out of a list of user emails I have? -To upload a group of user (or group) profiles and easily sort them into a cohort, add a value to the CSV which sorts the profiles into a cohort as a property. For example, give each profile the unique property of "Cohort = Android Users". Next, go to the [Cohorts](/docs/users/cohorts#creating-cohorts) tab to create a cohort as usual, and filter to user profiles with that property and save. This will create a cohort of users with that matching property. +To upload a group of user (or group) profiles and easily sort them into a cohort, add a value to the CSV which sorts the profiles into a cohort as a property. For example, give each profile the unique property of "Cohort = Android Users". Next, go to the [Cohorts](/docs/users/cohorts#creating-cohorts) tab to create a cohort as usual, and filter to user profiles with that property and save. This will create a cohort of users with that matching property. Note that when creating cohorts this way, the cohort will remain static, meaning that it will not update over time like other cohorts as the property is unchanging. ### How do I download User Profiles in Mixpanel? -To download your user profiles from the Users page, simply click the **Export icon.** This will download all the profile data being displayed in the current report - to download more properties, edit your columns to select more properties. You can choose to filter the list or select individual profiles to download instead of downloading the full list. +To download your user profiles from the Users page, simply click the **Export icon.** This will download all the profile data being displayed in the current report - to download more properties, edit your columns to select more properties. You can choose to filter the list or select individual profiles to download instead of downloading the full list. ![/Screen_Shot_2022-07-12_at_2.26.45_PM.png](/Screen_Shot_2022-07-12_at_2.26.45_PM.png) diff --git a/pages/guides/launch/create-boards.mdx b/pages/guides/launch/create-boards.mdx index 9f97fac512..375f5fe9a5 100644 --- a/pages/guides/launch/create-boards.mdx +++ b/pages/guides/launch/create-boards.mdx @@ -21,8 +21,8 @@ If you're new to your company or product analytics in general, one of the best w 3. Our Mixpanel Customer Success Team have also created boards in our demo projects that you can copy into your own projects. These include [boards to help with monitoring the quality of the data](https://mixpanel.com/project/3018488/view/3536632/app/boards/#id=6664368) you bring into Mixpanel, and [boards for troubleshooting your data](https://mixpanel.com/project/3018488/view/3536632/app/boards/#id=6664372). ## Creating and Sharing Your Board -Once you've created your own board, you can [share](/docs/boards/advanced#sharing) it with your coworkers within your organization for them to view or add creators to it and start collaborating. They need to have a Mixpanel login to access these boards. +Once you've created your own board, you can [share](/docs/boards/sharing-and-permission) it with your coworkers within your organization for them to view or add creators to it and start collaborating. They need to have a Mixpanel login to access these boards. If you want to share the board outside of your organization (anyone without a Mixpanel login to your project), you can do so via [public boards](/docs/boards/public-boards). Note that your Project Owner has to first enable the feature in your [Project Settings](https://mixpanel.com/settings/project), but once done, all project users except those with the role "Consumers" will be able to create public board links. -In certain instances, e.g. communication with your executives, you might want to send an email of the top metrics instead of links to the live board itself. You can do that via [Board Subscriptions](/docs/boards/advanced#board-subscriptions). These emails, which can also be sent as Slack messages, allow you to schedule and share the most recent metrics with both project members and external audiences. +In certain instances, e.g. communication with your executives, you might want to send an email of the top metrics instead of links to the live board itself. You can do that via [Board Subscriptions](/docs/boards#board-subscriptions). These emails, which can also be sent as Slack messages, allow you to schedule and share the most recent metrics with both project members and external audiences. diff --git a/pages/guides/playbooks/project-migration.md b/pages/guides/playbooks/project-migration.md index fd847e4910..e21e969a43 100644 --- a/pages/guides/playbooks/project-migration.md +++ b/pages/guides/playbooks/project-migration.md @@ -405,7 +405,7 @@ Saved entities, such as reports, boards, custom events, custom properties, cohor 💡 **Best Practices:** - **Prioritize Key Entities:** Focus on migrating the most important and frequently used entities first to ensure critical business functions continue uninterrupted. - **Collaborate with Stakeholders:** Involve key stakeholders throughout the migration process to ensure that their needs are met and that the migrated entities align with their expectations. -- **Boards & Reports**: Utilize [Move](/docs/boards/advanced#move-board) to transfer saved boards and reports across the same region (i.e. US, EU data centers). Permissions are managed by group admins allowing Boards to be moved across Projects or Organizations, depending on your use case. +- **Boards & Reports**: Utilize [Move](/docs/boards/move-boards) to transfer saved boards and reports across the same region (i.e. US, EU data centers). Permissions are managed by group admins allowing Boards to be moved across Projects or Organizations, depending on your use case. - Move does not support the migration of custom events, custom properties, cohorts, and lexicon metadata. This would need to be done manually. Review these lists with stakeholders and decide if any of these saved entities would need to be recreated in the new project to set your end users up for success. - Lexicon metadata can be [retrieved](https://developer.mixpanel.com/reference/list-all-schemas-for-project) from existing projects and [recreated](https://developer.mixpanel.com/reference/upload-schemas-for-project) in the new project via our Lexicon Schemas API. diff --git a/redirects/local.txt b/redirects/local.txt index 4bbd7e0f46..6c91508586 100644 --- a/redirects/local.txt +++ b/redirects/local.txt @@ -265,3 +265,4 @@ /docs/features/revenue_analytics /guides/launch/revenue-analytics /docs/tracking-methods/data-warehouse#mirror /docs/tracking-methods/warehouse-connectors#mirror /docs/tracking-methods/data-warehouse /docs/tracking-methods/warehouse-connectors +/docs/boards/advanced /docs/boards \ No newline at end of file