diff --git a/playbooks/docs/promote.yaml b/playbooks/docs/promote.yaml
index 501b368..d131255 100644
--- a/playbooks/docs/promote.yaml
+++ b/playbooks/docs/promote.yaml
@@ -10,7 +10,7 @@
       vars:
         # download_artifact_job: provided by zuul job
         download_artifact_api: "https://zuul.opendev.org/api/tenant/{{ zuul.tenant }}"
-        download_artifact_name: docs_archive
+        download_artifact_type: docs_archive
         download_artifact_pipeline: gate
     - name: Create working directory
       file:
diff --git a/zuul.d/jobs.yaml b/zuul.d/jobs.yaml
index fd3171e..920651e 100644
--- a/zuul.d/jobs.yaml
+++ b/zuul.d/jobs.yaml
@@ -419,9 +419,10 @@
          The name of the job which built the artifacts which this
          job should download and promote.
 
-      .. zuul:jobvar:: download_artifact_name
+      .. zuul:jobvar:: download_artifact_type
 
-         The name of the artifact.
+         The type of the artifact to download (as specified in the
+         ``type`` attribute of the artifact metadata).
 
       .. zuul:jobvar:: artifact_extra_name
 
@@ -442,7 +443,7 @@
       sdist and wheel(s) built in the gate pipeline.
     vars:
       download_artifact_job: build-python-release
-      download_artifact_name:
+      download_artifact_type:
         - python_sdist
         - python_wheel
     secrets:
@@ -460,7 +461,7 @@
       javascript content archive built in the gate pipeline.
     vars:
       download_artifact_job: build-javascript-content-tarball
-      download_artifact_name: javascript_content
+      download_artifact_type: javascript_content
       artifact_extra_name: js-content
     secrets:
       - secret: opendev-zuul-tarballs