Landing page: GraphQL API (#60339)

jc-clark · web-flow · commit d0cf23e0f73a · 2026-03-19T17:13:53.000Z
diff --git a/content/graphql/guides/forming-calls-with-graphql.md b/content/graphql/guides/forming-calls-with-graphql.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Form calls with GraphQL
+category:
+  - Get started and make API calls
 ---
 
 ## Authenticating with GraphQL
diff --git a/content/graphql/guides/introduction-to-graphql.md b/content/graphql/guides/introduction-to-graphql.md
@@ -8,6 +8,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Get started and make API calls
 ---
 
 ## GraphQL terminology
diff --git a/content/graphql/guides/managing-enterprise-accounts.md b/content/graphql/guides/managing-enterprise-accounts.md
@@ -7,6 +7,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Manage enterprise accounts
+category:
+  - Get started and make API calls
 ---
 
 ## About managing enterprise accounts with GraphQL
diff --git a/content/graphql/guides/migrating-from-rest-to-graphql.md b/content/graphql/guides/migrating-from-rest-to-graphql.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Migrate from REST to GraphQL
+category:
+  - Understand API changes and limits
 ---
 
 ## Differences in API logic
diff --git a/content/graphql/guides/migrating-graphql-global-node-ids.md b/content/graphql/guides/migrating-graphql-global-node-ids.md
@@ -5,6 +5,8 @@ versions:
   fpt: '*'
   ghec: '*'
 shortTitle: Migrating global node IDs
+category:
+  - Understand API changes and limits
 ---
 
 ## Background
diff --git a/content/graphql/guides/using-global-node-ids.md b/content/graphql/guides/using-global-node-ids.md
@@ -7,6 +7,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Get started and make API calls
 ---
 
 You can access most objects in GitHub (users, issues, pull requests, etc.) using either the REST API or the GraphQL API. You can find the **global node ID** of many objects from within the REST API and use these IDs in your GraphQL operations. For more information, see [Preview GraphQL API Node IDs in REST API resources](https://developer.github.com/changes/2017-12-19-graphql-node-id/).
diff --git a/content/graphql/guides/using-graphql-clients.md b/content/graphql/guides/using-graphql-clients.md
@@ -9,6 +9,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Get started and make API calls
 ---
 
 
diff --git a/content/graphql/guides/using-pagination-in-the-graphql-api.md b/content/graphql/guides/using-pagination-in-the-graphql-api.md
@@ -6,6 +6,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: Pagination
+category:
+  - Get started and make API calls
 ---
 
 ## About pagination
diff --git a/content/graphql/guides/using-the-graphql-api-for-discussions.md b/content/graphql/guides/using-the-graphql-api-for-discussions.md
@@ -6,6 +6,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: Use GraphQL for Discussions
+category:
+  - Get started and make API calls
 ---
 
 The {% data variables.product.prodname_discussions %} GraphQL API allows you to get, create, edit, and delete discussion posts. For more information about {% data variables.product.prodname_discussions %}, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/about-discussions).
diff --git a/content/graphql/index.md b/content/graphql/index.md
@@ -4,24 +4,25 @@ intro: 'To create integrations, retrieve data, and automate your workflows, use
 shortTitle: GraphQL API
 introLinks:
   overview: /graphql/overview/about-the-graphql-api
-featuredLinks:
-  startHere:
-    - /graphql/guides/forming-calls-with-graphql
-    - /graphql/guides/introduction-to-graphql
-    - /graphql/guides/using-graphql-clients
-  popular:
-    - /graphql/overview/public-schema
-    - /graphql/guides/using-pagination-in-the-graphql-api
-  guideCards:
-    - /graphql/guides/migrating-from-rest-to-graphql
-    - /graphql/guides/managing-enterprise-accounts
-    - /graphql/guides/using-global-node-ids
+  quickstart: /graphql/guides/forming-calls-with-graphql
 changelog:
   label: 'api, apis'
-layout: product-landing
+layout: discovery-landing
 redirect_from:
   - /v4
   - /graphql/overview/schema-previews
+includedCategories:
+  - Get started and make API calls
+  - Explore the schema reference
+  - Understand API changes and limits
+carousels:
+  recommended:
+    - /graphql/overview/about-the-graphql-api
+    - /graphql/guides/introduction-to-graphql
+    - /graphql/guides/forming-calls-with-graphql
+    - /graphql/guides/using-pagination-in-the-graphql-api
+    - /graphql/guides/migrating-from-rest-to-graphql
+    - /graphql/overview/rate-limits-and-query-limits-for-the-graphql-api
 versions:
   fpt: '*'
   ghec: '*'
@@ -30,4 +31,5 @@ children:
   - /overview
   - /reference
   - /guides
+contentType: landing
 ---
diff --git a/content/graphql/overview/about-the-graphql-api.md b/content/graphql/overview/about-the-graphql-api.md
@@ -5,6 +5,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Get started and make API calls
 ---
 
 ## Overview
diff --git a/content/graphql/overview/breaking-changes.md b/content/graphql/overview/breaking-changes.md
@@ -8,6 +8,8 @@ versions:
   ghec: '*'
   ghes: '*'
 autogenerated: graphql
+category:
+  - Understand API changes and limits
 ---
 
 ## About breaking changes
@@ -19,4 +21,4 @@ Breaking changes are any changes that might require action from our integrators.
 
 We'll announce upcoming breaking changes at least three months before making changes to the GraphQL schema, to give integrators time to make the necessary adjustments. Changes go into effect on the first day of a quarter (January 1st, April 1st, July 1st, or October 1st). For example, if we announce a change on January 15th, it will be made on July 1st.
 
-<!-- Content after this section is automatically generated -->
+<!-- Content after this section is automatically generated -->
diff --git a/content/graphql/overview/changelog.md b/content/graphql/overview/changelog.md
@@ -6,6 +6,8 @@ redirect_from:
 versions:
   fpt: '*'
 autogenerated: graphql
+category:
+  - Understand API changes and limits
 ---
 
 Breaking changes include changes that will break existing queries or could affect the runtime behavior of clients. For a list of breaking changes and when they will occur, see our [breaking changes log](/graphql/overview/breaking-changes).
diff --git a/content/graphql/overview/public-schema.md b/content/graphql/overview/public-schema.md
@@ -7,6 +7,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Get started and make API calls
 ---
 
 You can [perform introspection](/graphql/guides/introduction-to-graphql#discovering-the-graphql-api) against the GraphQL API directly.
diff --git a/content/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api.md b/content/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api.md
@@ -10,6 +10,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Understand API changes and limits
 ---
 
 ## Primary rate limit
diff --git a/content/graphql/reference/enums.md b/content/graphql/reference/enums.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 autogenerated: graphql
+category:
+  - Explore the schema reference
 ---
 
 ## About enums
diff --git a/content/graphql/reference/input-objects.md b/content/graphql/reference/input-objects.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 autogenerated: graphql
+category:
+  - Explore the schema reference
 ---
 
 ## About input objects
diff --git a/content/graphql/reference/interfaces.md b/content/graphql/reference/interfaces.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 autogenerated: graphql
+category:
+  - Explore the schema reference
 ---
 
 ## About interfaces
diff --git a/content/graphql/reference/mutations.md b/content/graphql/reference/mutations.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 autogenerated: graphql
+category:
+  - Explore the schema reference
 ---
 
 ## About mutations
diff --git a/content/graphql/reference/objects.md b/content/graphql/reference/objects.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 autogenerated: graphql
+category:
+  - Explore the schema reference
 ---
 
 ## About objects
diff --git a/content/graphql/reference/queries.md b/content/graphql/reference/queries.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 autogenerated: graphql
+category:
+  - Explore the schema reference
 ---
 
 ## About queries
diff --git a/content/graphql/reference/scalars.md b/content/graphql/reference/scalars.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 autogenerated: graphql
+category:
+  - Explore the schema reference
 ---
 
 ## About scalars
diff --git a/content/graphql/reference/unions.md b/content/graphql/reference/unions.md
@@ -9,6 +9,8 @@ versions:
   ghec: '*'
   ghes: '*'
 autogenerated: graphql
+category:
+  - Explore the schema reference
 ---
 
 ## About unions
