Homepage

Docs > Internal Developer Portal > Homepage

Overview

The IDP Homepage provides a centralized view of your team’s entities and your daily tasks.

With this view, you can:

View key information about your team’s entities, including scorecards, recent deployments, monitors, issues, incidents, dashboards, and on-call status.
Track tasks assigned to you across GitHub, GitLab, Jira, and Linear.
Identify alerting monitors or failed deployments.

Prerequisites

The Homepage aggregates data from your Datadog integrations. Configure the following before using the Homepage:

GitHub: Required for the GitHub tab in Your PRs. An administrator configures the GitHub integration and webhook, and each user signs in with their GitHub account.
GitLab: Required for the GitLab tab in Your PRs. An administrator configures the GitLab integration and webhook, and each user signs in with their GitLab account.
Jira: Required for the Jira tab in Your Tickets. An administrator configures the Jira webhook.
Linear: Required for the Linear tab in Your Tickets. An administrator configures the Linear webhook.

Configure the Homepage

Click Configure at the top of the IDP Homepage to personalize the page. The Homepage settings panel opens with two tabs: Section layout and Integrations. After you make changes, click Save to apply them, or Cancel to discard them.

Section layout

The Section layout tab controls which sections appear on the Homepage and the order in which they display. The available sections are: Your PRs, Your Tickets, Services & Entities, and Apps.

To reorder a section, drag it by its handle to a new position.
To show or hide a section, click the visibility icon next to it.
To restore the default sections and order, click Reset Layout.

Integrations

The Integrations tab controls which integrations are enabled and what each shows on the Homepage. Integrations are grouped by the section they populate, such as PRs and Work Items.

Each integration has a toggle to enable or disable it. When you disable an integration, its data no longer appears on the Homepage. Depending on the integration, you can also:

Select which connected account, instance, or organization to display. For example, the GitLab integration includes an Instance selector.
Open the integration’s configuration to manage its connection. For example, the GitHub integration includes a Configure option.

Your PRs

The Your PRs section consolidates your personal action items from source control, so you can track the pull requests and merge requests assigned to you without leaving the Homepage. Switch between the GitHub and GitLab tabs to view each source.

GitHub

The GitHub tab surfaces the pull requests that need your attention, grouped by review state, so you can act on them without leaving the Homepage.

After you sign in with your GitHub account, the tab loads your pull requests, grouped by status. If your organization has not configured the GitHub integration, this tab displays an empty state with a prompt to enable it from the GitHub integration tile. To read PRs from GitHub, this integration requires the following permissions:

Members: Read
Metadata: Read
Pull Requests: Read
Contents: Read
Statuses: Read
Checks: Read

If multiple GitHub organizations are connected in Datadog, you need the Integrations Read permission to switch between them.

GitLab

The GitLab tab surfaces the merge requests that need your attention, grouped by review state. For each one, it shows review and approval status, pipeline status and merge blockers, and resolved and unresolved discussion counts.

After you sign in with your GitLab account, the tab loads your merge requests, grouped by status. If your organization has not configured the GitLab integration, this tab displays an empty state with a prompt to enable it from the GitLab integration tile.

If you have multiple GitLab instances connected within Datadog, use the Instance selector to choose which instance to view.

Your tickets

The Your Tickets section consolidates the items assigned to you across Jira, Linear, and Datadog Work Management, so you can track your open work without leaving the Homepage. Switch between the Jira, Linear, and Work Items tabs to view each source, and use Display to change how items are shown.

Jira

The Jira tab lists the Jira tickets assigned to you, grouped by status. After setup, your assigned tickets appear automatically.

Linear

The Linear tab lists the Linear issues assigned to you, grouped by status. After setup, your assigned issues appear automatically.

Work Items

The Work Items tab lists the Datadog Work Management work items assigned to you, grouped by status. Work items appear automatically when they are assigned to you. For more information, see Work Management.

Services and entities

The Services & Entities section displays your team’s key services and entities, aggregated automatically from linked Datadog products and integrations. Each entry summarizes operational context for the entity, such as scorecard health, recent deployments, monitor and incident status, linked dashboards, and current on-call. You can filter by recently viewed entities, entities owned by your team, or entities you’ve favorited.

Extend the Homepage with custom apps

In addition to the built-in sections, the Apps section lets you add custom apps to the Homepage, so you can bring together the data and actions you find most useful, whether they come from Datadog, an internal tool, or a third-party service. Datadog provides two ways to build these apps:

App Builder: A low-code, drag-and-drop builder for internal tools. Apps combine prebuilt UI components, Datadog data sources (such as metrics, logs, and monitors), and out-of-the-box actions for services such as GitHub, GitLab, and AWS. For more information, see App Builder.
Datadog Apps: A code-based path for apps you build locally with React and TypeScript (or JavaScript), using a CLI and your standard development workflow. Choose Datadog Apps when you need team collaboration with source control and CI/CD, AI-assisted local development, integration with services beyond the Action Catalog, or full control over the app’s UI and logic. For more information, see Datadog Apps.

To make a custom app available here, first publish it and define its permissions so that your team can view and use it.

To add an app to the Homepage:

In the Apps section, click Add App.
Choose a blueprint to start from a prebuilt app, or choose a custom app that your organization has already built.
Configure the app, then add it to the Homepage.