PyCharm Unresolved Reference: Installed Package Not Recognized

How to fix it

Try these in order — the most common fix is first.

1. 1. Check the interpreter and install the package there

   Copy steps
   1. Click the Python Interpreter widget and confirm the right environment
   2. Open View | Tool Windows | Python Packages, search the package and click Install
   Did this fix it? Yes No

2. 2. Reload the interpreter paths

   Copy steps
   1. Ctrl+Alt+S, then Python | All Interpreters, select the interpreter
   2. Click Show Interpreter Paths, then the Reload the interpreter paths icon
   3. Or press Shift twice, type Rescan and run Rescan Available Python Modules and Packages
   Did this fix it? Yes No

3. 3. Add a missing path

   1. In the Interpreter Paths dialog click Add a path and choose the folder
   Did this fix it? Yes No

Symptoms

Red 'Unresolved reference' on imports even though the package works in a terminal.

Why it happens

• The project uses a different interpreter than the one where you ran pip
• The package location is not among the interpreter paths
• Package list is stale

This guide also covers

• pycharm unresolved reference
• pycharm package not recognized
• pycharm module not found
• pycharm import not resolved

Other PyCharm errors

• PyCharm Invalid Python Interpreter / Invalid Environment
• PyCharm No Python Interpreter Configured for the Project
• PyCharm Cannot Install or Find a Package
• PyCharm Conda Executable Not Found / Conda Environment Not Detected
• PyCharm Indexing Takes Forever / Stuck on Analyzing Project
• PyCharm Low Memory Warning: How to Increase the Heap Size
• PyCharm Invalidate Caches / Restart: When and How
• PyCharm Debugger Not Working / Breakpoints Not Hit