diff --git a/openedx/core/djangoapps/xblock/runtime/shims.py b/openedx/core/djangoapps/xblock/runtime/shims.py
index 516521d412..b23643393b 100644
--- a/openedx/core/djangoapps/xblock/runtime/shims.py
+++ b/openedx/core/djangoapps/xblock/runtime/shims.py
@@ -143,7 +143,9 @@ class RuntimeShim:
         """
         warnings.warn(
             "Use of runtime.render_template is deprecated. "
-            "Use xblockutils.resources.ResourceLoader.render_mako_template or a JavaScript-based template instead.",
+            "For template files included with your XBlock (which is preferable), use "
+            "xblockutils.resources.ResourceLoader.render_mako_template to render them, or use a JavaScript-based "
+            "template instead. For template files that are part of the LMS/Studio, use the 'mako' XBlock service.",
             DeprecationWarning, stacklevel=2,
         )
         try: