Supported 'openapi‐generator‐maven‐plugin' Configuration options

The plugin openapi-generator-maven-plugin has various configurations, <configuration>, which will affect what will be generated and how it will be generated.

Since openapi-generator-maven-plugin uses mustache to generate classes, overriding these mustache templates may result in classes being generated incorrectly, or not at all. Because of this, the following table will describe which configurations are supported, are inapplicable or are known to cause issues.

Important

This list of <configuration>-options are sourced from openapi-generator-maven-plugin/README.md, and may not always be up-to-date. For this reason, please refer to the original source for the detailed description of each option. The version being used can be found in the pom.xml-file.

Note

The options can be set either in the build <configuration>-tag, or by the complete property name prefixed by openapi.generator.maven.plugin.{option}.

Option	Applicable	Checked	Supported	Works as Designed	Additional Comments
verbose
inputSpec
inputSpecRootDirectory
mergedFileName
language
generatorName
cleanupOutput
output
gitHost
gitUserId
gitRepoId
collapsedSpec
includeCollapsedSpecInArtifacts
templateDirectory	❌
templateResourcePath
engine
auth
configurationFile
skipOverwrite
apiPackage
modelPackage	✔️	✔️	✔️	✔️
invokerPackage
packageName
groupId	❌
artifactId	❌
artifactVersion	❌
library	✔️	✔️	❗	❌	Planned to support okhttp-gson (default) and webclient
modelNamePrefix	✔️	✔️	✔️	✔️
modelNameSuffix	✔️	✔️	✔️	✔️
apiNameSuffix
ignoreFileOverride
httpUserAgent
removeOperationIdPrefix
skipOperationExample
logToStderr
enablePostProcessFile
skipValidateSpec
strictSpec
openapiNormalizer
generateAliasAsModel
configOptions	✔️	✔️	❗	❌	Planned to support configOptions for okhttp-gson (default) and webclient
instantiationTypes
importMappings
typeMappings
schemaMappings
nameMappings
modelNameMappings
parameterNameMappings
inlineSchemaNameMappings
inlineSchemaOptions
languageSpecificPrimitives
additionalProperties
serverVariableOverrides
reservedWordsMappings
generateApis
apisToGenerate
generateModels	✔️	✔️	✔️	✔️
modelsToGenerate
generateSupportingFiles
supportingFilesToGenerate
generateModelTests
generateModelDocumentation
generateApiTests
generateApiDocumentation
skip
skipIfSpecIsUnchanged
addCompileSourceRoot
addTestCompileSourceRoot
dryRun
environmentVariables
globalProperties
configHelp