How to Enable JavaDocs Tooltips in IntelliJ IDEA on Windows 11

When coding in IntelliJ IDEA, having quick access to documentation is essential — especially when you’re working with Java libraries, frameworks, or APIs. IntelliJ includes a built-in JavaDocs Tooltip feature that lets you instantly view method descriptions, parameters, and return types directly in the editor.

However, sometimes these JavaDocs tooltips may not appear automatically — either due to a disabled setting or missing library documentation. In this guide, we’ll show you exactly how to enable JavaDocs tooltips in IntelliJ IDEA and make them work perfectly on your Windows 11 setup.

What Are JavaDocs Tooltips in IntelliJ IDEA?

JavaDocs Tooltips are small pop-ups that show up when you hover your mouse over a class, method, or variable in IntelliJ. They display the Java documentation (Javadoc) for that symbol, saving you from switching back and forth between code and browser pages.

Here’s what they help you do:

Instantly view method or class documentation
See parameter and return type descriptions
Get clarification about third-party libraries
Boost productivity without leaving the editor

If your JavaDocs aren’t showing up, don’t worry — it’s usually a quick fix.

Step 1: Enable JavaDocs Tooltips in IntelliJ Settings

The first step is to make sure that the “Show quick documentation on mouse move” feature is enabled in IntelliJ.

Open IntelliJ IDEA on your Windows 11 system.
Go to the top menu and select:
File → Settings (or press Ctrl + Alt + S).
In the sidebar, navigate to:
Editor → Code Editing → Documentation
Under the Documentation section, check the box that says: Show quick documentation on mouse move
(Optional) Adjust the delay time (e.g., 500 ms) for how quickly the tooltip appears after hovering.
Click Apply → OK to save the changes.

Now hover your cursor over any Java class or method. You should see a tooltip pop up with the documentation.

Step 2: Use the Shortcut for Quick Documentation

If you prefer not to use mouse hover, IntelliJ provides a handy shortcut for viewing documentation anytime.

Place your cursor over the method or class name.
Press: Ctrl + Q (On macOS, use F1).

This opens the quick documentation popup — and if JavaDocs are available for that class, you’ll see the full details instantly.

Step 3: Attach External JavaDocs (If Missing)

If your tooltip says “No documentation found”, it usually means IntelliJ can’t locate the Javadoc files for your libraries or SDK.

To fix that, you need to attach the JavaDocs manually:

For the Java SDK:

Go to File → Project Structure → SDKs.
Select your installed JDK (for example, “Oracle OpenJDK 21”).
In the right pane, click the Documentation Paths tab.
Click + Add and paste this link if you’re using Oracle’s JDK: https://docs.oracle.com/en/java/javase/21/docs/api/
Click Apply → OK.

Now IntelliJ can pull official documentation directly from the web whenever you hover over a method or press Ctrl + Q.

Step 4: Attach JavaDocs for External Libraries

If you’re using frameworks like Spring Boot, Hibernate, or other external JARs, you can also attach their documentation manually.

In the Project View, right-click the library under External Libraries.
Choose Library Settings or Configure Library.
Under Documentation Paths, click the + icon and add the URL or folder containing the Javadoc files.

For example, for Spring Boot:

https://docs.spring.io/spring-boot/docs/current/api/

Once added, you’ll see full documentation tooltips for classes and methods from that library too.

Step 5: Verify JavaDoc Availability in the Project

Sometimes IntelliJ can’t fetch documentation because the JDK or library was installed without docs. To verify:

Open the Project Structure (Ctrl + Alt + Shift + S).
Under Project SDK, check if it points to the correct JDK installation.
If not, click Add SDK → JDK, and choose the folder where your JDK is installed.
Rebuild your project after changing the SDK.

Once IntelliJ reindexes your project, JavaDocs should start appearing automatically.

Step 6: Enable External Documentation View (Optional)

If you want IntelliJ to open the full online documentation in your browser instead of the tooltip:

Hover over a method or class name.
Right-click → External Documentation.
IntelliJ will open the corresponding JavaDoc page in your default browser.

This is especially useful when you need detailed explanations with examples or inheritance details.

Step 7: Fix Common JavaDocs Tooltip Issues

If you’ve followed all steps but still don’t see tooltips, here are a few troubleshooting tips:

1. Reindex IntelliJ Project

Go to File → Invalidate Caches / Restart → Invalidate and Restart.
This clears corrupted indexes and rebuilds documentation links.

2. Check JDK Configuration

Ensure your JDK is not a runtime-only version. You need a full JDK with developer documentation access.

3. Use the Latest IntelliJ Version

Older IntelliJ builds sometimes have bugs that prevent tooltips from appearing. Update to the latest version from Help → Check for Updates.

4. Disable Conflicting Plugins

Some third-party IntelliSense or code insight plugins might interfere. Try disabling them under Settings → Plugins.

Quick Summary

Task	Shortcut / Setting
Enable Tooltip	Settings → Editor → Code Editing → Documentation → ✅ Show quick documentation on mouse move
View Docs Quickly	`Ctrl + Q`
Attach SDK Docs	File → Project Structure → SDKs → Documentation Paths
Rebuild Index	File → Invalidate Caches / Restart
View Full Docs	Right-click → External Documentation

Wrapping Up

Enabling JavaDocs Tooltips in IntelliJ IDEA can significantly speed up your development workflow by giving you instant access to library and method documentation — right within the editor.

Once configured correctly, you can hover over any symbol, press Ctrl + Q, or even view full online docs in seconds. Whether you’re learning Java or working on enterprise applications, this feature helps you code faster and smarter.

So, turn those JavaDocs tooltips on — and make IntelliJ IDEA your ultimate productivity companion!