From 76258d071a6813cc66bfd5ec62f37c1e532a18b0 Mon Sep 17 00:00:00 2001
From: Rapptz <rapptz@gmail.com>
Date: Mon, 18 Aug 2025 13:27:18 -0400
Subject: [PATCH] Add note for File.uri and ASCII only names

---
 discord/file.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/discord/file.py b/discord/file.py
index c0649d539..2d7260ff1 100644
--- a/discord/file.py
+++ b/discord/file.py
@@ -133,6 +133,12 @@ class File:
     @property
     def uri(self) -> str:
         """:class:`str`: Returns the ``attachment://<filename>`` URI for this file.
+        This is used in certain places such as embeds or components to refer
+        to an uploaded file via URL.
+
+        .. info::
+            Due to Discord's filename processing it can only reference files
+            that have fully ASCII filenames.
 
         .. versionadded:: 2.6
         """