--- title: Homepage description: >- The Internal Developer Portal Homepage gives you a centralized view of your team's entities, GitHub pull requests, GitLab merge requests, Jira and Linear tickets, and Datadog Work Items in one place. breadcrumbs: Docs > Internal Developer Portal > Homepage --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # 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_2.fe32030bbe8d00901f10e3744408d78c.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/idp_homepage_2.fe32030bbe8d00901f10e3744408d78c.png?auto=format&fit=max&w=850&dpr=2 2x" alt="The IDP Homepage showing pull requests awaiting review and assigned 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, GitLab, Jira, and Linear. - Identify alerting monitors or failed deployments. ## Prerequisites{% #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](https://docs.datadoghq.com/integrations/github.md) and webhook, and each user signs in with their GitHub account. - **GitLab Source Code**: Required for the **GitLab** tab in **Your PRs**. An administrator configures the [GitLab Source Code integration](https://docs.datadoghq.com/integrations/gitlab-source-code.md) 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](https://docs.datadoghq.com/integrations/jira.md#configure-a-jira-webhook). - **Linear**: Required for the **Linear** tab in **Your Tickets**. An administrator [configures the Linear webhook](https://docs.datadoghq.com/integrations/linear.md#configure-a-linear-webhook). ## Configure the Homepage{% #configure-the-homepage %} Click **Configure** at the top of the [IDP Homepage](https://app.datadoghq.com/idp/home) 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{% #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{% #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{% #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. {% image source="https://docs.dd-static.net/images/tracing/software_catalog/your_prs_table.c18b448917187fdf059787777c7fbe45.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/your_prs_table.c18b448917187fdf059787777c7fbe45.png?auto=format&fit=max&w=850&dpr=2 2x" alt="The Your PRs section showing GitHub pull requests grouped by status." /%} ### GitHub{% #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](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 If multiple GitHub organizations are connected in Datadog, you need the Integrations Read permission to switch between them. ### GitLab{% #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 Source Code integration, this tab displays an empty state with a prompt to enable it from the [GitLab Source Code integration tile](https://docs.datadoghq.com/integrations/gitlab-source-code.md). If you have multiple GitLab instances connected within Datadog, use the **Instance** selector to choose which instance to view. ## Your tickets{% #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. {% image source="https://docs.dd-static.net/images/tracing/software_catalog/your_tickets_table.d825e64eed798d4fae6b24af9b6a65e8.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/your_tickets_table.d825e64eed798d4fae6b24af9b6a65e8.png?auto=format&fit=max&w=850&dpr=2 2x" alt="The Your Tickets section showing Jira tickets grouped by status." /%} ### Jira{% #jira %} The **Jira** tab lists the Jira tickets assigned to you, grouped by status. After setup, your assigned tickets appear automatically. ### Linear{% #linear %} The **Linear** tab lists the Linear issues assigned to you, grouped by status. After setup, your assigned issues appear automatically. ### Work Items{% #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](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_2.afd525ef4a641f236bd0f912f0bf240f.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/services_entities_table_2.afd525ef4a641f236bd0f912f0bf240f.png?auto=format&fit=max&w=850&dpr=2 2x" alt="The Services and entities section showing team services with scorecard, monitor, and on-call information." /%} 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{% #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 %} Additional helpful documentation, links, and articles: - [Start your day with the IDP Homepage](https://www.datadoghq.com/blog/datadog-idp-homepage/) - [Learn about the GitHub integration](https://docs.datadoghq.com/integrations/github.md) - [Learn about the GitLab Source Code integration](https://docs.datadoghq.com/integrations/gitlab-source-code.md) - [Learn about the Jira integration](https://docs.datadoghq.com/integrations/jira.md#configure-a-jira-webhook) - [Learn about the Linear integration](https://docs.datadoghq.com/integrations/linear.md#configure-a-linear-webhook)