---
title: Homepage
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Internal Developer Portal > Homepage
---

# Homepage

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}).
{% /alert %}

{% /callout %}

{% image
   source="https://docs.dd-static.net/images/tracing/software_catalog/idp_homepage.434c8a18d3909cf7ed931cb4c6775c7d.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/idp_homepage.434c8a18d3909cf7ed931cb4c6775c7d.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="IDP Homepage showing a personalized view of GitHub pull requests awaiting review and Jira tickets" /%}

## Overview{% #overview %}

The [IDP Homepage](https://app.datadoghq.com/idp/home) 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 and Jira.
- Identify alerting monitors or failed deployments.

## Prerequisites{% #prerequisites %}

The Homepage aggregates data from your Datadog integrations. To populate the task sections, configure the following integrations and webhooks before using the Homepage:

- **GitHub**: Install and configure the GitHub integration, and set up a GitHub webhook so that repository events (such as pull request activity) reach Datadog in real time. The **GitHub PRs** section requires this webhook to display current pull request data. For setup steps, see [GitHub](https://docs.datadoghq.com/integrations/github.md).
- **Jira**: Configure the Jira integration, and set up a Jira webhook so that issue events reach Datadog. The **Jira** tab in the **Your Tickets** section requires this webhook to display your assigned issues. For setup steps, see [Configure a Jira webhook](https://docs.datadoghq.com/integrations/jira.md#configure-a-jira-webhook).

## GitHub PRs{% #github-prs %}

{% image
   source="https://docs.dd-static.net/images/tracing/software_catalog/github_prs_table.5ce1c98c75de9e1d9f7e91e395486e0d.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/github_prs_table.5ce1c98c75de9e1d9f7e91e395486e0d.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="PRs assigned to the user" /%}

The **GitHub PRs** section consolidates your personal action items from GitHub, displaying PRs in the following states:

- **Needs your review**
- **Returned to you**
- **Approved**
- **Waiting for reviewers**
- **Recently merged**

Each PR includes:

- **Repository and PR number**
- **Title**
- **Status** (Open / Draft / Merged)
- **Assignee / Reviewer**

If your organization has not configured the GitHub integration, this section displays an empty state with a prompt to enable it from the [GitHub integration tile](https://docs.datadoghq.com/integrations/github.md). To read PRs from GitHub, this integration requires the following permissions:

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

In addition to these permissions, the **GitHub PRs** section requires a configured GitHub webhook so that pull request events reach Datadog in real time. For setup steps, see [GitHub](https://docs.datadoghq.com/integrations/github.md).

If you have multiple GitHub orgs connected within Datadog, users must have the Datadog Integrations Read Permissions to toggle between orgs.

## Your tickets{% #your-tickets %}

{% image
   source="https://docs.dd-static.net/images/tracing/software_catalog/homepage_tickets.61ea125b8c56fe2e11a7c84d22970054.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/homepage_tickets.61ea125b8c56fe2e11a7c84d22970054.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Your Tickets section showing Jira and Cases tabs with items assigned to the user" /%}

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

### Jira{% #jira %}

The **Jira** tab lists the Jira tickets assigned to you, grouped by status category: **To Do**, **In Progress**, and **Done**. Each ticket includes:

- **Key**
- **Title** (with a comment count when comments exist)
- **Status**
- **Created**
- **Updated**
- **Priority**
- **Due**
- **Assignee**

### Cases{% #cases %}

The **Cases** tab lists the Datadog Case Management cases assigned to you, grouped by status: **Open**, **In Progress**, and **Closed**. Each group shows a count.

Each case includes:

- **Case key**
- **Title** (with a comment count when comments exist)
- **Status**
- **Updated**
- **Priority**
- **Due date**
- **Assignee**

Cases appear automatically when they are assigned to you. For more information, see [Case Management](https://docs.datadoghq.com/service_management/case_management.md).

## Services and entities{% #services-and-entities %}

{% image
   source="https://docs.dd-static.net/images/tracing/software_catalog/services_entities_table.17d19884f4d1ffe9d2951d11eb4adf4e.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/services_entities_table.17d19884f4d1ffe9d2951d11eb4adf4e.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Services & entities for the user" /%}

The **Services & Entities** section displays your team's key services and entities, aggregated automatically from linked Datadog products and integrations. You can filter by recently viewed entities, entities owned by your team, or entities you've favorited.

Each entity includes the following information:

| Field           | Description                                                                            |
| --------------- | -------------------------------------------------------------------------------------- |
| **Type**        | The entity type (for example, Service, Monitor, or Incident).                          |
| **Name**        | The entity's display name or identifier.                                               |
| **Scorecards**  | A summary of the entity's health based on reliability, performance, and error budgets. |
| **Last Deploy** | The most recent deployment detected by APM or CI integrations.                         |
| **Monitors**    | The number and status of monitors associated with the entity.                          |
| **Issues**      | Active issues related to the entity, aggregated from linked tracking tools.            |
| **Incidents**   | Open incidents associated with the team's entities.                                    |
| **Dashboards**  | Key dashboards linked to the entity.                                                   |
| **On-Call**     | The current on-call responder for the team or entity.                                  |

## Extend the Homepage with custom apps{% #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 and AWS. For more information, see [App Builder](https://docs.datadoghq.com/actions/app_builder.md).
- **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](https://docs.datadoghq.com/actions/datadog_apps.md).

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:

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

## Further reading{% #further-reading %}

- [Learn about the GitHub Integration](https://docs.datadoghq.com/integrations/github.md)