diff --git a/pages/file-storage/concepts.mdx b/pages/file-storage/concepts.mdx
new file mode 100644
index 0000000000..59c953b968
--- /dev/null
+++ b/pages/file-storage/concepts.mdx
@@ -0,0 +1,52 @@
+---
+meta:
+ title: File Storage - Concepts
+ description: Explore essential concepts of File Storage.
+content:
+ h1: File Storage - Concepts
+ paragraph: Explore essential concepts of File Storage.
+tags: file storage file system concept glossary terms definitions
+dates:
+ validation: 2025-06-25
+ posted: 2025-06-25
+categories:
+ - file-storage
+ - storage
+---
+
+## Attach
+
+Attaching storage to your Scaleway Instance enables you to use additional or shared storage beyond its [Local Storage](/local-storage/).
+
+## Availability Zone
+
+
+
+## Block volumes
+
+
+
+## File Storage
+
+Scaleway File Storage allows you to keep data in an organized hierarchy of files and folders. This hierarchy can be shared across a network, so multiple compute instances can work on the same collection of files.
+
+## File system
+
+A file system provides a structured way to manage files and directories in the cloud, so that Instances can access, read, and write data as if it were on a local disk. File systems can be shared by several [Instances](/instances/).
+
+## IOPS
+
+IOPS or Input/Ouptut Operations Per Second, is a unit of measurement that indicates how many read/write operations a storage device is performing per second.
+
+Scaleway File Storage offers two IOPS limits:
+
+- 5 000 IOPS (5K IOPS)
+- 15 000 IOPS (15K IOPS)
+
+## Mount
+
+Mounting a storage volume allows you you to assign a directory (mount point) to an [attached](#attach) storage volume. The files on that storage become available via the assigned directory. This allows you to read and write files on the storage as if they were part of your local file system.
+
+## Region
+
+
diff --git a/pages/file-storage/faq.mdx b/pages/file-storage/faq.mdx
new file mode 100644
index 0000000000..b9dccc7c5c
--- /dev/null
+++ b/pages/file-storage/faq.mdx
@@ -0,0 +1,16 @@
+---
+meta:
+ title: File Storage
+ description: Explore Scaleway File Storage with our comprehensive FAQ covering performance, persistence, and more.
+content:
+ h1: File Storage FAQ
+dates:
+ created: 2025-06-25
+ validation: 2025-06-25
+category: storage
+productIcon: FileStorageProductIcon
+---
+
+## What is Scaleway File Storage?
+
+Scaleway File Storage allows you to keep data in an organized hierarchy of files and folders. This hierarchy can be shared across a network, so multiple compute instances can work on the same collection of files.
\ No newline at end of file
diff --git a/pages/file-storage/how-to/attach-file-system.mdx b/pages/file-storage/how-to/attach-file-system.mdx
new file mode 100644
index 0000000000..6354705136
--- /dev/null
+++ b/pages/file-storage/how-to/attach-file-system.mdx
@@ -0,0 +1,15 @@
+---
+meta:
+ title: &title How to attach a file system to a Scaleway Instance
+ description: &description This page explains how to attach a File Storage file system to Scaleway Instances
+content:
+ h1: *title
+ paragraph: *description
+tags: attach instance server fs filesystem file storage resource
+categories:
+ - storage
+ - file-storage
+dates:
+ validation: 2025-06-24
+ posted: 2025-06-24
+---
\ No newline at end of file
diff --git a/pages/file-storage/how-to/create-file-system.mdx b/pages/file-storage/how-to/create-file-system.mdx
new file mode 100644
index 0000000000..4cafc3dae4
--- /dev/null
+++ b/pages/file-storage/how-to/create-file-system.mdx
@@ -0,0 +1,16 @@
+---
+meta:
+ title: &title How to create a file system
+ description: &description This page explains how to create a File Storage file system using the Scaleway console.
+content:
+ h1: *title
+ paragraph: *description
+tags: create add deploy fs filesystem file storage resource
+categories:
+ - storage
+ - file-storage
+dates:
+ validation: 2025-06-24
+ posted: 2025-06-24
+---
+
diff --git a/pages/file-storage/how-to/delete-file-system.mdx b/pages/file-storage/how-to/delete-file-system.mdx
new file mode 100644
index 0000000000..3af1b55e37
--- /dev/null
+++ b/pages/file-storage/how-to/delete-file-system.mdx
@@ -0,0 +1,15 @@
+---
+meta:
+ title: &title How to delete a file system
+ description: &description This page explains how to delete a File Storage file system using the Scaleway console.
+content:
+ h1: *title
+ paragraph: *description
+tags: delete suppress cancel remove fs filesystem file storage resource
+categories:
+ - storage
+ - file-storage
+dates:
+ validation: 2025-06-24
+ posted: 2025-06-24
+---
diff --git a/pages/file-storage/how-to/detach-file-system.mdx b/pages/file-storage/how-to/detach-file-system.mdx
new file mode 100644
index 0000000000..63fcc14424
--- /dev/null
+++ b/pages/file-storage/how-to/detach-file-system.mdx
@@ -0,0 +1,15 @@
+---
+meta:
+ title: &title How to detach a file system from a Scaleway Instance
+ description: &description This page explains how to detach a File Storage file system from Scaleway Instances
+content:
+ h1: *title
+ paragraph: *description
+tags: detach instance server fs filesystem file storage resource
+categories:
+ - storage
+ - file-storage
+dates:
+ validation: 2025-06-24
+ posted: 2025-06-24
+---
\ No newline at end of file
diff --git a/pages/file-storage/how-to/index.mdx b/pages/file-storage/how-to/index.mdx
new file mode 100644
index 0000000000..e6df7f99c6
--- /dev/null
+++ b/pages/file-storage/how-to/index.mdx
@@ -0,0 +1,8 @@
+---
+meta:
+ title: File Storage - How Tos
+ description: File Storage How Tos
+content:
+ h1: File Storage - How Tos
+ paragraph: File Storage How Tos
+---
diff --git a/pages/file-storage/how-to/manage-file-system.mdx b/pages/file-storage/how-to/manage-file-system.mdx
new file mode 100644
index 0000000000..a4113d4f58
--- /dev/null
+++ b/pages/file-storage/how-to/manage-file-system.mdx
@@ -0,0 +1,15 @@
+---
+meta:
+ title: &title How to manage a file system
+ description: &description This page explains how to manage a File Storage file system using the Scaleway console.
+content:
+ h1: *title
+ paragraph: *description
+tags: manage update settings fs filesystem file storage resource
+categories:
+ - storage
+ - file-storage
+dates:
+ validation: 2025-06-24
+ posted: 2025-06-24
+---
diff --git a/pages/file-storage/how-to/mount-file-system.mdx b/pages/file-storage/how-to/mount-file-system.mdx
new file mode 100644
index 0000000000..62fa6348f7
--- /dev/null
+++ b/pages/file-storage/how-to/mount-file-system.mdx
@@ -0,0 +1,15 @@
+---
+meta:
+ title: &title How to mount a file system on a Scaleway Instance
+ description: &description This page explains how to mount a File Storage file system on Scaleway Instances using the Scaleway console
+content:
+ h1: *title
+ paragraph: *description
+tags: mount instance server fs filesystem file storage resource
+categories:
+ - storage
+ - file-storage
+dates:
+ validation: 2025-06-24
+ posted: 2025-06-24
+---
\ No newline at end of file
diff --git a/pages/file-storage/how-to/unmount-file-system.mdx b/pages/file-storage/how-to/unmount-file-system.mdx
new file mode 100644
index 0000000000..23b6add128
--- /dev/null
+++ b/pages/file-storage/how-to/unmount-file-system.mdx
@@ -0,0 +1,15 @@
+---
+meta:
+ title: &title How to unmount a file system from a Scaleway Instance
+ description: &description This page explains how to unmount a File Storage file system from Scaleway Instances using the Scaleway console
+content:
+ h1: *title
+ paragraph: *description
+tags: unmount instance server fs filesystem file storage resource
+categories:
+ - storage
+ - file-storage
+dates:
+ validation: 2025-06-24
+ posted: 2025-06-24
+---
\ No newline at end of file
diff --git a/pages/file-storage/index.mdx b/pages/file-storage/index.mdx
new file mode 100644
index 0000000000..7a32ea4a13
--- /dev/null
+++ b/pages/file-storage/index.mdx
@@ -0,0 +1,62 @@
+---
+meta:
+ title: File Storage Documentation
+ description: Explore Scaleway File Storage with quickstart guides, how-tos, and more.
+---
+
+
+
+
+## Getting Started
+
+
+
+
+
+
+
+
+
+
+## Changelog
+
+
diff --git a/pages/file-storage/quickstart.mdx b/pages/file-storage/quickstart.mdx
new file mode 100644
index 0000000000..f724d96b2e
--- /dev/null
+++ b/pages/file-storage/quickstart.mdx
@@ -0,0 +1,15 @@
+---
+meta:
+ title: File Storage - Quickstart
+ description: Get started with Scaleway File Storage. This guide covers creating, attaching, and mounting File systems to your Instances for efficient data management.
+content:
+ h1: File Storage - Quickstart
+ paragraph: Get started with Scaleway File Storage. This guide covers creating, attaching, and mounting File Storagefile systems to your Instances for efficient data management.
+tags: file storage overview get started
+dates:
+ validation: 2025-06-24
+ posted: 2025-06-24
+categories:
+ - file-storage
+ - storage
+---
\ No newline at end of file