diff --git a/doc/integration/img/jira_issue_reference.png b/doc/integration/img/jira_issue_reference.png
index 1a2d9f04a6c..463200da6aa 100644
Binary files a/doc/integration/img/jira_issue_reference.png and b/doc/integration/img/jira_issue_reference.png differ
diff --git a/doc/integration/img/jira_service_close_comment.png b/doc/integration/img/jira_service_close_comment.png
new file mode 100644
index 00000000000..84a71c692b1
Binary files /dev/null and b/doc/integration/img/jira_service_close_comment.png differ
diff --git a/doc/integration/img/jira_service_close_issue.png b/doc/integration/img/jira_service_close_issue.png
index eed69e80d2c..b033b210469 100644
Binary files a/doc/integration/img/jira_service_close_issue.png and b/doc/integration/img/jira_service_close_issue.png differ
diff --git a/doc/integration/jira.md b/doc/integration/jira.md
index 2e31fd994de..4c1b8b2bdd3 100644
--- a/doc/integration/jira.md
+++ b/doc/integration/jira.md
@@ -54,16 +54,19 @@ contains the improvement and in merge request description we say that this
 merge request `Closes PROJECT-7` issue.
 
 Once this merge request is merged, the JIRA issue will be automatically closed
-with a link to the commit that resolved the issue.
+with a comment and a associated link to the commit that resolved the issue.
 
 ![A Git commit that causes the JIRA issue to be closed](img/jira_merge_request_close.png)
 
 ---
 
-![The GitLab integration user leaves a comment on JIRA](img/jira_service_close_issue.png)
+![The GitLab integration closes JIRA issue](img/jira_service_close_issue.png)
 
 ---
 
+![The GitLab integration creates a comment and a link on JIRA issue.](img/jira_service_close_comment.png)
+
+
 ## Configuration
 
 ### Configuring JIRA