From a341058350ee7522dfd524a546e0bb1ced33720a Mon Sep 17 00:00:00 2001 From: Cameron Blackwood <38852603+Reikon95@users.noreply.github.com> Date: Fri, 23 Jan 2026 01:03:02 +0000 Subject: [PATCH] docs: add docs for file name limitations in storage (#41889) * docs: add docs for file name limitations in storage * docs: ran prettier on storage file limits section * docs: remove accidental inclusion of forward slash as a valid character --------- Co-authored-by: Chris Chinchilla --- apps/docs/content/guides/storage/uploads/file-limits.mdx | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/apps/docs/content/guides/storage/uploads/file-limits.mdx b/apps/docs/content/guides/storage/uploads/file-limits.mdx index 2fe49b2be10..89c29fe1cc6 100644 --- a/apps/docs/content/guides/storage/uploads/file-limits.mdx +++ b/apps/docs/content/guides/storage/uploads/file-limits.mdx @@ -28,3 +28,12 @@ Additionally, you can specify the maximum file size on a per [bucket level](/doc ## Per bucket restrictions You can have different restrictions on a per bucket level such as restricting the file types (e.g. `pdf`, `images`, `videos`) or the maximum file size, which should be lower than the global limit. To apply these limits on a bucket level see [Creating Buckets](/docs/guides/storage/buckets/creating-buckets#restricting-uploads). + +## File name restrictions + +File names can only include the following characters: + +- **Alphanumeric**: `A-Z`, `a-z`, `0-9` +- **Punctuation**: `_` (underscore), `-` (hyphen), `.` (dot), `'` (apostrophe), `,` (comma) +- **Special characters**: `!`, `*`, `&`, `$`, `@`, `=`, `;`, `:`, `+`, `?`, `(`, `)` +- **Whitespace**