diff --git a/doc/source/conf.py b/doc/source/conf.py
index 63fca218436aaa2a8d2bb02a7ce60557ee326471..96ddf85634b4a9bf7a438339cdc6c1434a3134c0 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -132,6 +132,7 @@ else:
 GLOBAL_VARIABLE_MAP = {
     '|KOLLA_OPENSTACK_RELEASE|': KOLLA_OPENSTACK_RELEASE,
     '|KOLLA_BRANCH_NAME|': KOLLA_BRANCH_NAME,
+    '|KOLLA_BRANCH_NAME_DASHED|': KOLLA_BRANCH_NAME.replace('/', '-'),
     '|TESTED_RUNTIMES_GOVERNANCE_URL|': TESTED_RUNTIMES_GOVERNANCE_URL,
 }
 
diff --git a/doc/source/reference/bare-metal/ironic-guide.rst b/doc/source/reference/bare-metal/ironic-guide.rst
index 1354677959933b21447716d4fcb9fe1b85aa9eda..f01d4ee309578eb84a4460f63dc5fc6eabe11cee 100644
--- a/doc/source/reference/bare-metal/ironic-guide.rst
+++ b/doc/source/reference/bare-metal/ironic-guide.rst
@@ -82,10 +82,10 @@ be used:
 
 .. code-block:: console
 
-   $ curl https://tarballs.opendev.org/openstack/ironic-python-agent/dib/files/ipa-centos8-master.kernel \
+   $ curl https://tarballs.opendev.org/openstack/ironic-python-agent/dib/files/ipa-centos8-|KOLLA_BRANCH_NAME_DASHED|.kernel \
      -o /etc/kolla/config/ironic/ironic-agent.kernel
 
-   $ curl https://tarballs.opendev.org/openstack/ironic-python-agent/dib/files/ipa-centos8-master.initramfs \
+   $ curl https://tarballs.opendev.org/openstack/ironic-python-agent/dib/files/ipa-centos8-|KOLLA_BRANCH_NAME_DASHED|.initramfs \
      -o /etc/kolla/config/ironic/ironic-agent.initramfs
 
 You may optionally pass extra kernel parameters to the inspection kernel using: