With PyCharm 5.0 we finally got to select Google and NumPy Style Python Docstrings templates.

It is also mentioned in the whatsnew section for PyCharm 5.0.

How to change the Docstring Format:

File --> Settings --> Tools --> Python Integrated Tools

There you can choose from the available Docstrings formats:

Plain, Epytext, reStructuredText, NumPy, Google

As pointed out by jstol: for Mac users, this is under

PyCharm -> Preferences -> Tools -> Python Integrated Tools.

Answer from Nras on Stack Overflow
Discussions

Showing documentation in PyCharm - Stack Overflow
How do I get PyCharm to display documentation in popup instead of suggesting me external link? Image below shows what happens now when I press ctrl+Q on NumPy method "where". IDe suggest open external documentation, although documentation is right there visible on a screen and available. ... Not sure why it doesn't default to loading the local module docstring ... More on stackoverflow.com
🌐 stackoverflow.com
python - How to change PyCharms docstring autocomplete? - Stack Overflow
I have been programming in PyCharm ... I have defined PyCharm will autocomplete the docstring using what I believe is sphinx style formatting. Example in picture below: I'd like to change this format to something appear like the docstrings throughout the numpy module... More on stackoverflow.com
🌐 stackoverflow.com
Change docstring style for a project's entire codebase
You can change the default style that is auto-generated by PyCharm. https://www.jetbrains.com/help/pycharm/settings-tools-python-integrated-tools.html To convert the existing docstrings you will need to use a tool like pyment https://stackoverflow.com/questions/44955366/simple-way-to-convert-python-docstrings-from-restructured-text-to-google-style More on reddit.com
🌐 r/pycharm
4
5
May 17, 2021
What format do you use for your docstrings?
ReST since that is what is supported natively by Sphinx. Tried Google style docstrings and could never get it to work easily with RTD More on reddit.com
🌐 r/Python
12
11
July 21, 2017
🌐
JetBrains
jetbrains.com › help › pycharm › using-docstrings-to-specify-types.html
Specify types with docstrings | PyCharm Documentation
September 1, 2025 - PyCharm will generate a :return: and :rtype: section (or their equivalent in the selected docstring format). Place the caret at the function name, and press Alt+Enter. In the list of intention actions that opens, choose Specify return type in docstring. The reStructuredText is used for all the subsequent examples, but it is possible to use any of the supported formats of the documentation strings, whether it is plain text, Google or NumPy...
🌐
JetBrains
jetbrains.com › help › pycharm › settings-tools-python-integrated-tools.html
Integrated Tools | PyCharm Documentation
July 19, 2026 - Use this page to configure requirements management file, default test runner, and documentation strings treatment · Package requirements file
🌐
JetBrains
intellij-support.jetbrains.com › hc › en-us › community › posts › 115000784410-how-to-change-pycharm-default-commenting-style-for-function-
how to change pycharm default commenting style for function? – IDEs Support (IntelliJ Platform) | JetBrains
December 20, 2017 - ... """ validating the closure ... How? ... Hi Pswpeterpab! You can switch docstring style in Settings | Tools | Python Integrated Tools | Docstring format, you are looking for NumPy style I believe....
🌐
JetBrains
jetbrains.com › help › pycharm › type-syntax-for-docstrings.html
Legacy type syntax for docstrings | PyCharm Documentation
March 18, 2026 - PyCharm supports legacy approach ... · NumPy · Google · To choose the desired docstring format, use the Python Integrated Tools page of the Settings dialog....
🌐
YouTube
youtube.com › jorge anais
How to change doc style to numpy in Pycharm - YouTube
Step by step:Settings→ Tools→ Python Integrated Tools→ Docstring Format→ NumPy
Published: September 7, 2020
Views: 228
🌐
GitHub
github.com › modflowpy › flopy › issues › 67
Numpy docstrings now supported in Pycharm 5 · Issue #67 · modflowpy/flopy
November 27, 2015 - Pycharm now supports Numpy docstrings, which is what we use in flopy. Instructions for setting it up can be found at: https://www.jetbrains.com/pycharm/help/python-integrated-tools.html
Author: modflowpy
Find elsewhere
🌐
JetBrains
youtrack.jetbrains.com › issue › PY-30843 › Numpy-and-Google-docstring-rendering-fails-in-PyCharm-2017.3.3
Numpy and Google docstring rendering fails in PyCharm ...
Our website uses some cookies and records your IP address for the purposes of accessibility, security, and managing your access to the telecommunication network. You can disable data collection and cookies by changing your browser settings, but it may affect how this website functions.
🌐
Readthedocs
sphinxcontrib-napoleon.readthedocs.io › en › latest › example_numpy.html
Example NumPy Style Python Docstrings — napoleon 0.7 documentation
Properties created with the ``@property`` decorator should be documented in the property's getter method. Attributes ---------- attr1 : str Description of `attr1`. attr2 : :obj:`int`, optional Description of `attr2`. """ def __init__(self, param1, param2, param3): """Example of docstring on the __init__ method.
🌐
JetBrains
youtrack.jetbrains.com › issue › PY-38970
Jetbrains
March 27, 2022 - Our website uses some cookies and records your IP address for the purposes of accessibility, security, and managing your access to the telecommunication network. You can disable data collection and cookies by changing your browser settings, but it may affect how this website functions.
🌐
JetBrains
youtrack.jetbrains.com › issue › PY-73986 › Pycharm-quick-documentation-not-rendering-Numpy-style-docstrings
Pycharm quick documentation not rendering Numpy style ...
Our website uses some cookies and records your IP address for the purposes of accessibility, security, and managing your access to the telecommunication network. You can disable data collection and cookies by changing your browser settings, but it may affect how this website functions.
🌐
PyCharm Help
pleiades.io › help › pycharm › using-docstrings-to-specify-types.html
docstring で型を指定する | PyCharm ドキュメント
開いたインテンションアクションのリストで、 docstring に戻り値の型を指定する を選択します。 · 以降のすべての例では reStructuredText を使用していますが、ドキュメント文字列はプレーンテキスト、Google、NumPy など、サポートされている任意の形式を使用できます。 詳細については、 統合ツール を参照してください。
🌐
JetBrains
youtrack.jetbrains.com › issue › PY-38970 › Python-docstring-in-numpy-format-are-not-parsed-or-rendered-correctly
Python docstring in numpy format are not parsed or ...
Our website uses some cookies and records your IP address for the purposes of accessibility, security, and managing your access to the telecommunication network. You can disable data collection and cookies by changing your browser settings, but it may affect how this website functions.
🌐
JetBrains
jetbrains.com › help › pycharm › generating-reference-documentation.html
Generate reference documentation | PyCharm Documentation
August 4, 2025 - Add docstrings to your Python functions, classes, or exceptions in the source code.
🌐
JetBrains
youtrack.jetbrains.com › issue › PY-4717
Support for NumpyDoc : PY-4717 - YouTrack
Our website uses some cookies and records your IP address for the purposes of accessibility, security, and managing your access to the telecommunication network. You can disable data collection and cookies by changing your browser settings, but it may affect how this website functions.
🌐
pythontutorials
pythontutorials.net › blog › numpy-style-docstrings
Mastering NumPy Style Docstrings: A Comprehensive Guide — pythontutorials.net
This will print the entire NumPy style docstring of the add_numbers function. Most modern Python Integrated Development Environments (IDEs) like PyCharm and VS Code can display docstrings automatically.
🌐
Medium
medium.com › @djnrrd › automatic-documentation-with-pycharm-70d37927df57
Automatic Documentation with PyCharm | by DJ Nrrd | Medium
April 21, 2020 - At the top of the docstring, provide a brief one line description of the function. Then if you need anything wordy, type that in a new paragraph, keeping everything at the same indentation level (I’ve taken to having PyCharm hard wrap on 80 columns as well).