External Plugin

This is a third-party plugin. Please report issues in its Github Repository(opens new window)

# Hardhat Docgen

Generate NatSpec documentation automatically on compilation with Hardhat.

# Installation

yarn add --dev hardhat-docgen

# Usage

Load plugin in Hardhat config:


Add configuration under the docgen key:

option description default
path path to HTML export directory (relative to Hardhat root) './docgen'
clear whether to delete old files in path on documentation generation false
runOnCompile whether to automatically generate documentation during compilation false
docgen: {
  path: './docs',
  clear: true,
  runOnCompile: true,

The path directory will be created if it does not exist.

The clear option is set to false by default because it represents a destructive action, but should be set to true in most cases.

The included Hardhat task may be run manually; however, it is imperative that the compile task be run at least once after plugin installation to ensure that the correct compiler options are set:

yarn run hardhat docgen