From da5b04002584c74d2a2dda0a5d4f0df9ae66c48a Mon Sep 17 00:00:00 2001
From: Isabel Matwawana <isabel.matwawana@grafana.com>
Date: Tue, 16 Dec 2025 10:12:46 -0500
Subject: [PATCH] Added admonition

---
 .../panels-visualizations/visualizations/canvas/index.md    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/sources/visualizations/panels-visualizations/visualizations/canvas/index.md b/docs/sources/visualizations/panels-visualizations/visualizations/canvas/index.md
index 821d547d7d3..92bca5511c0 100644
--- a/docs/sources/visualizations/panels-visualizations/visualizations/canvas/index.md
+++ b/docs/sources/visualizations/panels-visualizations/visualizations/canvas/index.md
@@ -117,6 +117,12 @@ You can add a custom icon by referencing an SVG file. To add a custom icon, foll
 
    {{< figure src="/media/docs/grafana/panels-visualizations/screenshot-canvas-custom-image-v11.3.png" max-width="250px" alt="Add a custom image URL" >}}
 
+   {{< admonition type="caution" >}}
+   Using the `public/img` directory as a server for custom images is not supported.
+   This type of usage was possible prior to Grafana v12.1, but it was never supported.
+   If you did this before Grafana v12.1, your image file paths will no longer work and you'll need to move your images to an accessible URL as indicated in this step.
+   {{< /admonition >}}
+
 1. Click **Select**.
 1. (Optional) Add a background image to your icon with the **Background (icon)** option by following the steps to [add a custom image](#add-custom-images-to-elements).