diff --git a/zuul.d/project-templates.yaml b/zuul.d/project-templates.yaml
index ff3545677e..a62e0cd509 100644
--- a/zuul.d/project-templates.yaml
+++ b/zuul.d/project-templates.yaml
@@ -164,3 +164,27 @@
     gate:
       jobs:
         - openstack-ansible-linters-ubuntu-bionic
+
+- project-template:
+    name: openstack-ansible-deploy-guide-jobs
+    description: |
+      Build the deploy-guide document and publish the result
+      using a promote job.
+    check:
+      jobs:
+        - build-openstack-deploy-guide:
+            files: &deploy-guide-triggers
+              - ^deploy-guide/.*
+              - ansible-role-requirements.yml
+              - bindep.txt
+              - doc/requirements.txt
+              - test-requirements.txt
+              - tox.ini
+    gate:
+      jobs:
+        - build-openstack-deploy-guide:
+            files: *deploy-guide-triggers
+    promote:
+      jobs:
+        - promote-deploy-guide:
+            files: *deploy-guide-triggers
diff --git a/zuul.d/project.yaml b/zuul.d/project.yaml
index c7101727b5..d1418ca4cc 100644
--- a/zuul.d/project.yaml
+++ b/zuul.d/project.yaml
@@ -14,7 +14,7 @@
 
 - project:
     templates:
-      - deploy-guide-jobs
+      - openstack-ansible-deploy-guide-jobs
       - openstack-ansible-deploy-base-jobs
       - openstack-ansible-deploy-aio_lxc-jobs
       - openstack-ansible-deploy-aio_distro_lxc-jobs