diff --git a/ansible/group_vars/all.yml b/ansible/group_vars/all.yml
index f1925628528a3a33a05fd0374a5977db4b498bd1..8e54e9376f223b85ef6675a0b43e41c04b18c18b 100644
--- a/ansible/group_vars/all.yml
+++ b/ansible/group_vars/all.yml
@@ -227,6 +227,7 @@ network_interface: "eth0"
 neutron_external_interface: "eth1"
 kolla_external_vip_interface: "{{ network_interface }}"
 api_interface: "{{ network_interface }}"
+# NOTE: storage_interface is deprecated, please set swift_storage_interface directly instead
 storage_interface: "{{ network_interface }}"
 swift_storage_interface: "{{ storage_interface }}"
 swift_replication_interface: "{{ swift_storage_interface }}"
diff --git a/doc/source/admin/production-architecture-guide.rst b/doc/source/admin/production-architecture-guide.rst
index 9f33d7f2b78ff443414c688d10489a1c16ac2bf7..30fc59e74bf32d65855bd0062e147c9edc83dde9 100644
--- a/doc/source/admin/production-architecture-guide.rst
+++ b/doc/source/admin/production-architecture-guide.rst
@@ -54,13 +54,14 @@ In Kolla operators should configure following network interfaces:
   ``kolla_enable_tls_external`` is set to yes. Defaults to
   ``network_interface``.
 
-* ``storage_interface`` - This is the interface that is used by Swift.
-  This can be heavily utilized so it's recommended to use a high speed
-  network fabric. Defaults to ``network_interface``.
+* ``storage_interface`` (**deprecated**) - Sets the default for
+  ``swift_storage_interface``. Defaults to ``network_interface``.
+  Please set ``swift_storage_interface`` directly instead.
 
 * ``swift_storage_interface`` - This interface is used by Swift for storage
   access traffic.  This can be heavily utilized so it's recommended to use
-  a high speed network fabric. Defaults to ``storage_interface``.
+  a high speed network fabric. Defaults to ``storage_interface``, will default
+  directly to ``network_interface`` in a future release.
 
 * ``swift_replication_interface`` - This interface is used by Swift for storage
   replication traffic.  This can be heavily utilized so it's recommended to use
diff --git a/doc/source/reference/storage/swift-guide.rst b/doc/source/reference/storage/swift-guide.rst
index 6f7887d6900e5689352775d63e8c5875cd00d871..40e6a8258acfea80fce3fbe67cea9db6615b47ec 100644
--- a/doc/source/reference/storage/swift-guide.rst
+++ b/doc/source/reference/storage/swift-guide.rst
@@ -22,7 +22,7 @@ Internal API interface (``api_interface``)
   used by HAProxy to access the Swift proxy servers.
 Swift Storage interface (``swift_storage_interface``)
   This interface is used by the Swift proxy server to access the account,
-  container and object servers. Defaults to ``storage_interface``.
+  container and object servers.
 Swift replication interface (``swift_replication_interface``)
   This interface is used for Swift storage replication traffic.
   This is optional as the default configuration uses
diff --git a/etc/kolla/globals.yml b/etc/kolla/globals.yml
index 1b409ae35deec812bdba138da30c373ea20249c6..59ab190df56f1331adf936bddc0989839286280a 100644
--- a/etc/kolla/globals.yml
+++ b/etc/kolla/globals.yml
@@ -127,6 +127,7 @@
 # the 'network_interface'. These interfaces must contain an IP address.
 #kolla_external_vip_interface: "{{ network_interface }}"
 #api_interface: "{{ network_interface }}"
+# NOTE: storage_interface is deprecated, please set swift_storage_interface directly instead
 #storage_interface: "{{ network_interface }}"
 #swift_storage_interface: "{{ storage_interface }}"
 #swift_replication_interface: "{{ swift_storage_interface }}"
diff --git a/releasenotes/notes/deprecate-storage-interface-8e82d446baff4da8.yaml b/releasenotes/notes/deprecate-storage-interface-8e82d446baff4da8.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e0abef94a879f85f34c38b22041e11f5a892e438
--- /dev/null
+++ b/releasenotes/notes/deprecate-storage-interface-8e82d446baff4da8.yaml
@@ -0,0 +1,7 @@
+---
+deprecations:
+  - |
+    The ``storage_interface`` variable is deprecated and will be removed in the
+    next release as it was causing confusion. The variable only sets the
+    default for ``swift_storage_interface`` which we now recommend to set
+    directly instead.