From bdac4d3737e51c0164653c624603060efc1c4415 Mon Sep 17 00:00:00 2001 From: Eli Polonsky Date: Tue, 19 May 2026 12:27:21 -0400 Subject: [PATCH] docs(migration): add Transformer v1 prerequisite and feature matrix entries - Add GraphQL Transformer v1 prerequisite to migration guide with link to the transformer migration guide - Add key, versioned, and connection directives to feature matrix as unsupported in Gen 2 --- .../start/migrate-to-gen2/feature-matrix/index.mdx | 3 +++ .../migrate-to-gen2/migrate-existing-app/index.mdx | 10 ++++++++++ 2 files changed, 13 insertions(+) diff --git a/src/pages/[platform]/start/migrate-to-gen2/feature-matrix/index.mdx b/src/pages/[platform]/start/migrate-to-gen2/feature-matrix/index.mdx index 98c46979cc3..952f715fb51 100644 --- a/src/pages/[platform]/start/migrate-to-gen2/feature-matrix/index.mdx +++ b/src/pages/[platform]/start/migrate-to-gen2/feature-matrix/index.mdx @@ -125,6 +125,9 @@ The migration tool does not convert your GraphQL schema to the native Gen 2 sche | auth - custom - function | Yes | Yes | 🟢 | | searchable | Yes | No (guide using Zero-ETL DynamoDB-to-OpenSearch) | 🔴 | | predictions | Yes | No (guide with AI service integrations) | 🔴 | +| key | Yes | [No](https://docs.amplify.aws/gen1/react/tools/cli/migration/transformer-migration/) | 🔴 | +| versioned | Yes | [No](https://docs.amplify.aws/gen1/react/tools/cli/migration/transformer-migration/) | 🔴 | +| connection | Yes | [No](https://docs.amplify.aws/gen1/react/tools/cli/migration/transformer-migration/) | 🔴 | | Custom Mutations, Queries, Subscriptions | Yes | Yes | 🟢 | | VTL handler | Yes | Yes with CDK | 🟢 | | JavaScript resolver handler | No | Yes | - | diff --git a/src/pages/[platform]/start/migrate-to-gen2/migrate-existing-app/index.mdx b/src/pages/[platform]/start/migrate-to-gen2/migrate-existing-app/index.mdx index d0e6f65df26..e30c852026c 100644 --- a/src/pages/[platform]/start/migrate-to-gen2/migrate-existing-app/index.mdx +++ b/src/pages/[platform]/start/migrate-to-gen2/migrate-existing-app/index.mdx @@ -128,6 +128,16 @@ Before starting the migration, carefully review the [Backend Categories](/[platf If your API has conflict resolution enabled (DataStore), you must disable it before proceeding with the Gen 2 migration. See the [Migrate from DataStore](/gen1/[platform]/build-a-backend/more-features/datastore/migrate-from-datastore/) guide for instructions. +### GraphQL Transformer v1 + +The migration tool does not support GraphQL Transformer v1 schemas. If your project still uses Transformer v1, you must migrate to v2 before proceeding. See the [Transformer migration guide](https://docs.amplify.aws/gen1/react/tools/cli/migration/transformer-migration/) for instructions. + + + +If you choose to skip this prerequisite, the `generate` step will prompt you to acknowledge the gap. Doing so will skip the data resource entirely — no Gen 2 data definition will be generated. You will need to manually write the Gen 2 data resource definition to restore your GraphQL API functionality. + + + ### GraphQL types protected by the `iam` auth provider If you have models protected by IAM: