From ceae69085b41fd81d5842b045f81c16961226968 Mon Sep 17 00:00:00 2001
From: Harshit Sharma <66710144+harshitethic@users.noreply.github.com>
Date: Sun, 30 Aug 2026 17:18:05 +0530
Subject: [PATCH] docs: clarify pip index configuration during PyPI migration

---
 source/guides/migrating-to-pypi-org.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/guides/migrating-to-pypi-org.rst b/source/guides/migrating-to-pypi-org.rst
index 2b565e8ee..40c0041fe 100644
--- a/source/guides/migrating-to-pypi-org.rst
+++ b/source/guides/migrating-to-pypi-org.rst
@@ -135,6 +135,21 @@ Downloading packages
 
 ``pypi.org`` is the default host for downloading packages.
 
+If you have configured pip to use a custom ``index-url``, that setting can
+override the default PyPI index. Check your pip configuration files if pip
+continues to use the old PyPI URL after migration. The command ``pip config
+list -v`` can be used to show the configuration files pip is loading.
+
+For example, a configuration containing::
+
+    [global]
+    index-url = https://pypi.python.org/pypi
+
+should be updated to use the current PyPI URL::
+
+    [global]
+    index-url = https://pypi.org/simple
+
 Managing published packages and releases
 ----------------------------------------