From: Motov Yurii <109919500+YuriiMotov@users.noreply.github.com>
Date: Tue, 17 Jun 2025 07:42:41 +0000 (+0200)
Subject: 📝 Clarify the middleware execution order in docs (#13699)
X-Git-Tag: 0.115.13~24
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=590abc4b9634fa8363cfec85487bb8825520a7e3;p=thirdparty%2Ffastapi%2Ffastapi.git

📝 Clarify the middleware execution order in docs (#13699)
---

diff --git a/docs/en/docs/tutorial/middleware.md b/docs/en/docs/tutorial/middleware.md
index 4f7980165c..b7c03a3199 100644
--- a/docs/en/docs/tutorial/middleware.md
+++ b/docs/en/docs/tutorial/middleware.md
@@ -65,6 +65,29 @@ Here we use <a href="https://docs.python.org/3/library/time.html#time.perf_count
 
 ///
 
+## Multiple middleware execution order
+
+When you add multiple middlewares using either `@app.middleware()` decorator or `app.add_middleware()` method, each new middleware wraps the application, forming a stack. The last middleware added is the *outermost*, and the first is the *innermost*.
+
+On the request path, the *outermost* middleware runs first.
+
+On the response path, it runs last.
+
+For example:
+
+```Python
+app.add_middleware(MiddlewareA)
+app.add_middleware(MiddlewareB)
+```
+
+This results in the following execution order:
+
+* **Request**: MiddlewareB → MiddlewareA → route
+
+* **Response**: route → MiddlewareA → MiddlewareB
+
+This stacking behavior ensures that middlewares are executed in a predictable and controllable order.
+
 ## Other middlewares
 
 You can later read more about other middlewares in the [Advanced User Guide: Advanced Middleware](../advanced/middleware.md){.internal-link target=_blank}.