Skip to content

Add custom user home page to landing page docs #35823

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tomnof wants to merge 6 commits into
base: master
Choose a base branch
from
+29 −7
Open

Add custom user home page to landing page docs #35823

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
cf34468
Add custom user home page documentation to landing page and account m…
tomnof Apr 7, 2026
db76662
Merge remote-tracking branch 'origin/master' into tom.nof/add-custom-…
tomnof Apr 7, 2026
3612990
Fix ordered list numbering to use incremental numbers
tomnof Apr 7, 2026
3da06b8
Refine wording for custom landing page and personal home page docs
tomnof Apr 7, 2026
99a2e8d
Update content/en/account_management/org_settings/custom_landing.md
tomnof Apr 8, 2026
cde1402
Incorporate PR review feedback for landing page overview section
tomnof Apr 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions content/en/account_management/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,18 @@ The visual accessibility preference has five different settings to address color

**Note**: Your visual accessibility preference is saved locally in your browser. If you use a different browser or clear your cache, the preference is set to the default setting.

### Home page

Set a personal home page to control which page you see when you log in to Datadog or navigate to the root URL. Your personal home page takes precedence over the [organization landing page][15], if allowed.
Copy link
Copy Markdown

@pgoldrbx pgoldrbx Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"if allowed." - I don't think we have any mechanism currently in place to control this as a permission or org config.


To set a personal home page:

1. Navigate to [**Personal Settings > Home Page**][16].
2. Select the page you want as your home page.
3. Click the **Save** button.

To revert to the organization default, return to [**Personal Settings > Home Page**][16] and clear your selection.

### Organizations

The [Organizations tab][12] in **Personal Settings** lists all of the organizations you are associated with. Switch between these organizations from this page or by hovering over the account menu in the left-side navigation.
Expand Down Expand Up @@ -154,3 +166,5 @@ To disable your Datadog organization account, contact [Datadog support][10].
[12]: https://app.datadoghq.com/personal-settings/organizations
[13]: https://app.datadoghq.com/personal-settings/application-keys
[14]: https://app.datadoghq.com/personal-settings/apps
[15]: /account_management/org_settings/custom_landing/
[16]: https://app.datadoghq.com/personal-settings/home-page
20 changes: 13 additions & 7 deletions content/en/account_management/org_settings/custom_landing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,34 +5,40 @@ description: Set a custom dashboard as your organization's landing page to contr

## Overview

The Datadog organization landing page is the first page your users see when they log on to Datadog or navigate to the Datadog root page. Datadog sets a default landing page for your organization. If you use APM, Datadog sets the APM root as the landing page. If you don't use APM, then the list of dashboards is the default landing page.
The Datadog organization landing page is the first page your users see when they log on to Datadog or navigate to the Datadog root page. Datadog determines which landing page to display based on the following priority:

As an alternative to the default page, Datadog allows administrators to set a dashboard as the landing page for the organization. A custom landing page helps a large or small organization control the narrative for their users.
1. **Custom user home page**: A [personal home page][3] set by the individual user.
2. **Custom organization home page**: A custom page chosen by an administrator for the entire organization.
3. **APM-enabled organizations**: The APM Home page.
4. **Default**: The Dashboard List.
Copy link
Copy Markdown

@pgoldrbx pgoldrbx Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It feels a bit awkward to define the organization landing page and then start the priority list with a user setting. Here's a possible alternative 🤖

The Datadog organization landing page is the first page your users see when they log in to Datadog or navigate to the Datadog root page. Organization administrators can set a custom default landing page. Individual users can override this by setting their own [personal home page][3].

The landing page a user sees is determined by the following priority:

  1. Personal home page: The user's [personal home page][3], if set.
  2. Custom organization home page: The custom default set by an administrator.
  3. APM Home: The default for APM-enabled organizations.
  4. Dashboard List: The fallback default.

Copy link
Copy Markdown
Contributor Author

@tomnof tomnof Apr 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good suggestion, adopted this rewrite.


You can customize a dashboard with the information you want your users to see when they first log on to Datadog. Use [Organization settings][1] to set that dashboard as the custom landing page for your organization.
**Note**: Trial organizations default to the Quick Start guide, and Studio organizations default to the Studio page. These take precedence over the priority list above.
Copy link
Copy Markdown

@pgoldrbx pgoldrbx Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NOTE: currently, Studio does not take priority over the custom organization page but it will take priority over APM or default (dashboard list)

Copy link
Copy Markdown
Contributor Author

@tomnof tomnof Apr 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, updated the note to clarify that Studio only takes precedence over APM/default, not the custom org page.


## Set a custom landing page
## Set a custom landing page for your organization

Only users with the Datadog Admin Role or the Org Management (`org_management`) permission can set the custom landing page for an organization. Custom landing pages are not available during free trial periods.

To set a custom landing page, follow the steps below:

1. Navigate to [Organization settings][1].
1. Navigate to [**Organization Settings**][1].
2. From the tabs on the left, select [**Preferences**][2].
3. In the Datadog Homepage section, click **Individual Dashboard**.
4. Use the dropdown list to select a dashboard.
5. Click the **Save** button.

As an administrator, you can also enforce a home page for your organization and prevent users from setting their own landing page.
Copy link
Copy Markdown

@pgoldrbx pgoldrbx Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe this does not exist. Am I wrong?

Copy link
Copy Markdown
Contributor Author

@tomnof tomnof Apr 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I tagged you on slack to create this lol (but to your point -- no, it doesn't exist today)


## Use the default landing page

Only users with the Datadog Admin Role or the Org Management (`org_management`) permission can change the landing page for an organization.

To restore the default landing page of APM Home, follow the steps below:
To restore the default landing page:

1. Navigate to [Organization settings][1].
1. Navigate to [**Organization Settings**][1].
2. From the tabs on the left, select [**Preferences**][2].
3. In the Datadog Homepage section, click **Default: Dashboard List**.
4. Click the **Save** button.

[1]: https://app.datadoghq.com/organization-settings/
[2]: https://app.datadoghq.com/organization-settings/preferences
[3]: /account_management/#home-page
Loading