Cosmos PG migration tool not visible as per docs

Question

Cosmos PG migration tool not visible as per docs

Mohammad Alinia 20

Hello there,

As per this page: https://learn.microsoft.com/en-us/azure/cosmos-db/postgresql/migrate-postgresql-elastic-cluster

the Cosmos PG migration tool should have been available since 13th of April but I cannot see it in Azure portal (my screenshot vs the screenshots in the docs below).

Can you please guide me where I can find this tool?

Thanks,
Mohammad

User's image

Kumar Rahul 0 Reputation points

2026-04-23T11:07:12.76+00:00
Open your Azure Cosmos DB for PostgreSQL cluster directly (not generic Cosmos DB account page).

In left menu, look for Migration under Settings / Management sections.

Verify your cluster version is PG16 + Citus 12.1.

Try Incognito / different browser / clear cache.

Switch portal directory/tenant if you use multiple tenants.

Check if your region has rollout completed.
Kumar Rahul 0 Reputation points

2026-04-23T11:07:44.2466667+00:00
If it still doesn’t appear, open an Azure support ticket. Mention:

Subscription ID

Region

Cluster name

PostgreSQL version

That docs say available from April 13 but Migration tab missing
Pilladi Padma Sai Manisha 7,710 Reputation points Microsoft External Staff Moderator

2026-04-23T12:00:39.16+00:00

Hi Mohammad Alinia,
Thankyou for reaching Microsoft Q&A!
Thank you for sharing the screenshot and the documentation link. The Migration option should be visible under the Azure Cosmos DB for PostgreSQL cluster blade, as shown in the latest documentation. If it is not appearing in your portal, the most likely reason is that the feature is being rolled out gradually and has not yet been enabled for your specific subscription, tenant, or region.

This kind of portal feature often becomes visible only after the backend rollout reaches the environment where your cluster is hosted. So even if the documentation says the feature is available, there can still be a delay before it shows up in every customer environment. In such cases, the portal may continue to display the older navigation layout without the Migration menu entry.

Please try the following:

Refresh the Azure portal and sign out/sign back in.

Confirm you are viewing the correct Azure Cosmos DB for PostgreSQL cluster.

Check again after some time, since the feature may still be pending enablement in your region or subscription.

If the Migration option still does not appear, then it is likely that the rollout has not reached your environment yet. In that case, the best next step is to wait for the feature to be enabled or raise a support request for confirmation on rollout status.
Pilladi Padma Sai Manisha 7,710 Reputation points Microsoft External Staff Moderator

2026-04-24T10:00:29.5666667+00:00

Hi Mohammad Alinia,
I hope you had a chance to review the information shared earlier, and I hope this information has been helpful! If you still have questions, please let us know what is needed in the comments so the question can be answered.
Saraswathi Devadula 16,020 Reputation points Microsoft External Staff Moderator

2026-04-29T05:15:27.2266667+00:00

Hi Mohammad Alinia, I hope you had a chance to review the information shared earlier, and I hope this information has been helpful! If you still have questions, please let us know what is needed in the comments so the question can be answered.

4 answers

Your answer

Kumar Rahul 0 Reputation points

2026-04-23T11:07:12.76+00:00

Open your Azure Cosmos DB for PostgreSQL cluster directly (not generic Cosmos DB account page).

In left menu, look for Migration under Settings / Management sections.

Verify your cluster version is PG16 + Citus 12.1.

Try Incognito / different browser / clear cache.

Switch portal directory/tenant if you use multiple tenants.

Check if your region has rollout completed.
Kumar Rahul 0 Reputation points

2026-04-23T11:07:44.2466667+00:00

If it still doesn’t appear, open an Azure support ticket. Mention:

Subscription ID

Region

Cluster name

PostgreSQL version

That docs say available from April 13 but Migration tab missing
Pilladi Padma Sai Manisha 7,710 Reputation points Microsoft External Staff Moderator

2026-04-23T12:00:39.16+00:00

Hi Mohammad Alinia,
Thankyou for reaching Microsoft Q&A!
Thank you for sharing the screenshot and the documentation link. The Migration option should be visible under the Azure Cosmos DB for PostgreSQL cluster blade, as shown in the latest documentation. If it is not appearing in your portal, the most likely reason is that the feature is being rolled out gradually and has not yet been enabled for your specific subscription, tenant, or region.

This kind of portal feature often becomes visible only after the backend rollout reaches the environment where your cluster is hosted. So even if the documentation says the feature is available, there can still be a delay before it shows up in every customer environment. In such cases, the portal may continue to display the older navigation layout without the Migration menu entry.

Please try the following:

Refresh the Azure portal and sign out/sign back in.

Confirm you are viewing the correct Azure Cosmos DB for PostgreSQL cluster.

Check again after some time, since the feature may still be pending enablement in your region or subscription.

If the Migration option still does not appear, then it is likely that the rollout has not reached your environment yet. In that case, the best next step is to wait for the feature to be enabled or raise a support request for confirmation on rollout status.
Pilladi Padma Sai Manisha 7,710 Reputation points Microsoft External Staff Moderator

2026-04-24T10:00:29.5666667+00:00

Hi Mohammad Alinia,
I hope you had a chance to review the information shared earlier, and I hope this information has been helpful! If you still have questions, please let us know what is needed in the comments so the question can be answered.
Saraswathi Devadula 16,020 Reputation points Microsoft External Staff Moderator

2026-04-29T05:15:27.2266667+00:00

Hi Mohammad Alinia, I hope you had a chance to review the information shared earlier, and I hope this information has been helpful! If you still have questions, please let us know what is needed in the comments so the question can be answered.

Answer 1

Saraswathi Devadula 16,020 Microsoft External Staff Moderator

Hi **Mohammad Alinia,
**
That is correct, document says that tool will be available starting from April 13th. Unfortunately, due to delays in depended on service deployments, we could not enable it.

It is about in final stages. Portal will start displaying the migration tab soon. Rough ETA is next week.

0 comments

Answer 2

Kumar Rahul 0

If it still doesn’t appear, open an Azure support ticket. Mention:

Subscription ID
Region
Cluster name
PostgreSQL version
That docs say available from April 13 but Migration tab missing

0 comments

Answer 3

It is supposed to be available inside your Azure Cosmos DB for PostgreSQL cluster resource page in the Azure portal as a Migration tab/menu item on the left navigation pane. Microsoft documentation explicitly says the tool will be available through the Migration tab.
Most likely reasons:

Phased rollout: Feature enabled subscription-by-subscription or region-by-region.
Unsupported cluster version: Microsoft noted migration support applies to clusters running PostgreSQL 16 with Citus 12.1.
Portal caching/UI lag: Old portal session may not show newly enabled features.
RBAC permissions: Limited permissions can hide management tabs. Open your Azure Cosmos DB for PostgreSQL cluster directly (not generic Cosmos DB account page).
- In left menu, look for Migration under Settings / Management sections.
- Verify your cluster version is PG16 + Citus 12.1.
- Try Incognito / different browser / clear cache.
Switch portal directory/tenant if you use multiple tenants.
Check if your region has rollout completed.

Answer 4

Marcin Policht 88,075 MVP Volunteer Moderator

As per https://learn.microsoft.com/en-us/answers/questions/5865447/when-will-azure-cosmos-db-for-postgresql-migration

• The feature is rolling out gradually across regions and subscriptions starting April 13, so you might not see it immediately in your portal instance.

If the above response helps answer your question, remember to "Accept Answer" so that others in the community facing similar issues can easily find the solution. Your contribution is highly appreciated.

hth

Marcin

0 comments

Share via

Cosmos PG migration tool not visible as per docs

4 answers

Your answer