diff --git a/modules/openstack_project/files/jenkins_job_builder/config/manuals-jobs.yaml b/modules/openstack_project/files/jenkins_job_builder/config/manuals-jobs.yaml
index b2b29ebb99..59fed7ef8b 100644
--- a/modules/openstack_project/files/jenkins_job_builder/config/manuals-jobs.yaml
+++ b/modules/openstack_project/files/jenkins_job_builder/config/manuals-jobs.yaml
@@ -37,6 +37,8 @@
 - job-group:
     name: openstack-doc-jobs
     jobs:
+      - gate-{name}-tox-{envlist}:
+          envlist: checklinks
       - gate-{name}-tox-{envlist}:
           envlist: checkniceness
       - gate-{name}-tox-{envlist}:
diff --git a/modules/openstack_project/files/zuul/layout.yaml b/modules/openstack_project/files/zuul/layout.yaml
index 5c465147e9..18384cb55e 100644
--- a/modules/openstack_project/files/zuul/layout.yaml
+++ b/modules/openstack_project/files/zuul/layout.yaml
@@ -351,6 +351,7 @@ project-templates:
 
   - name: openstack-doc-gate
     check:
+      - gate-{name}-tox-checklinks
       - gate-{name}-tox-checkniceness
       - gate-{name}-tox-checksyntax
       - gate-{name}-tox-checkdeletions
@@ -561,6 +562,9 @@ jobs:
   - name: ^gate-.*-tox-checklang$
     branch: master
     voting: false
+  - name: ^gate-.*-tox-checklinks$
+    branch: master
+    voting: false
   - name: ^gate-.*-docs$
     success-pattern: http://docs-draft.openstack.org/{build.parameters[LOG_PATH]}/doc/build/html/
   - name: ^gate-.*-js-draft