diff --git a/atlassian-connect-descriptor.cabal b/atlassian-connect-descriptor.cabal
--- a/atlassian-connect-descriptor.cabal
+++ b/atlassian-connect-descriptor.cabal
@@ -10,7 +10,7 @@
 -- PVP summary:      +-+------- breaking API changes
 --                   | | +----- non-breaking API additions
 --                   | | | +--- code changes with no API change
-version:             0.4.1.0
+version:             0.4.2.0
 
 -- A short (one-line) description of the package.
 synopsis:            Code that helps you create a valid Atlassian Connect Descriptor.
diff --git a/src/Data/Connect/Modules.hs b/src/Data/Connect/Modules.hs
--- a/src/Data/Connect/Modules.hs
+++ b/src/Data/Connect/Modules.hs
@@ -530,8 +530,9 @@
 -- | An 'Extraction' represents a snippet of data that should be extracted from a 'KeyConfiguration' such that it is
 -- Indexed by JIRA and capable of being searched in JQL.
 data Extraction = Extraction
-   { extractionObjectName :: T.Text
-   , extractionType       :: ExtractionType
+   { extractionObjectName :: T.Text -- ^ The json path to the data in the json data stored in this property.
+   , extractionType       :: ExtractionType -- ^ The type of data contained in this extraction. Arrays are automatically handled.
+   , extractionAlias      :: Maybe T.Text -- ^ The alias for this extraction to use in JQL queries.
    } deriving (Show, Generic)
 
 instance ToJSON Extraction where