Frequently asked question

What are the PYTHONNOUSERSITE changes at ArcGIS Pro 3.2?

Last Published: January 15, 2026

Answer

Pro 3.2 change

At Pro 3.2, Esri launched the Python embedded within Pro with the PYTHONNOUSERSITE option, this disables the importing of packages from the "user site packages" directory and avoids this class of problems. The PYTHONNOUSERSITE flag is only set in the ArcGIS Pro application. Standalone terminal sessions that run python.exe may still encounter problems. See the PYTHONNOUSERSITE documentation for command line options.

To ensure packages are installed in the environment rather than the user site packages directory, it is possible to add permissions to the active environment directory. This then allows read/write access for pip, and the user should then be able to work with all Python packages as usual.

Warning:   
The instructions below include making changes to essential parts of your operating system. It is recommended that you backup your operating system and files, including the registry, before proceeding. Consult a qualified computer systems professional, if necessary.
Esri cannot guarantee results from incorrect modifications while following these instructions. Therefore, use caution and proceed at your own risk.

If it is desireable to return to the default Python behavior to use the "use site packages" option, and it is necessary to share pip packages across environments, opt out of the altered Pro 3.2 behavior by setting the registry key below.

  • key path: Software\ESRI\ArcGISPro\Settings under the HKCU or HKLM as appropriate for your install type
  • key name: PythonAllowUserSitePackages
  • type: DWORD (32-bit) Value
  • hexadecimal value: 1 means enable user site packages

Article ID: 000031545

Software:
  • ArcGIS Pro

Get support with AI

Resolve your issue quickly with the Esri Support AI Chatbot.

Start chatting now

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Start chatting now

Go to download options