diff --git a/docs.json b/docs.json
index 3c5fe149..23b7b258 100644
--- a/docs.json
+++ b/docs.json
@@ -117,6 +117,7 @@
                   {
                     "group": "Flux",
                     "pages": [
+                      "tutorials/flux/flux-2-dev",
                       "tutorials/flux/flux1-krea-dev",
                       "tutorials/flux/flux-1-kontext-dev",
                       "tutorials/flux/flux-1-text-to-image",
@@ -738,6 +739,7 @@
                   {
                     "group": "Flux",
                     "pages": [
+                      "zh-CN/tutorials/flux/flux-2-dev",
                       "zh-CN/tutorials/flux/flux1-krea-dev",
                       "zh-CN/tutorials/flux/flux-1-kontext-dev",
                       "zh-CN/tutorials/flux/flux-1-text-to-image",
diff --git a/tutorials/flux/flux-2-dev.mdx b/tutorials/flux/flux-2-dev.mdx
new file mode 100644
index 00000000..87606636
--- /dev/null
+++ b/tutorials/flux/flux-2-dev.mdx
@@ -0,0 +1,64 @@
+---
+title: "ComfyUI Flux.2 Dev Example"
+description: "This guide provides a brief introduction to the Flux.2 model and guides you through using the Flux.2 Dev model for text-to-image generation in ComfyUI."
+sidebarTitle: "Flux.2 Dev"
+---
+
+import UpdateReminder from '/snippets/tutorials/update-reminder.mdx'
+
+## About FLUX.2
+
+[FLUX.2](https://bfl.ai/blog/flux-2) is a next-generation image model from [Black Forest Labs](https://blackforestlabs.ai/), delivering up to 4MP photorealistic output with far better lighting, skin, fabric, and hand detail. It adds reliable multi-reference consistency (up to 10 images), improved editing precision, better visual understanding, and professional-class text rendering.
+
+**Key Features:**
+- **Multi-Reference Consistency:** Reliably maintains identity, product geometry, textures, materials, wardrobe, and composition intent across multiple outputs
+- **High-Resolution Photorealism:** Generates images up to 4MP with real-world lighting behavior, spatial reasoning, and physics-aware detail
+- **Professional-Grade Control:** Exact pose control, hex-code accurate brand colors, any aspect ratio, and structured prompting for programmatic workflows
+- **Usable Text Rendering:** Produces clean, legible text across UI screens, infographics, and multi-language content
+
+**Available Models:**
+- **FLUX.2 Dev:** Open-source model (used in this tutorial)
+- **FLUX.2 Pro:** API version from Black Forest Labs
+
+<Note>
+We are using quantized weights in this workflow. The original FLUX.2 repository is available [here](https://huggingface.co/black-forest-labs/FLUX.2-dev/).
+</Note>
+
+<UpdateReminder/>
+
+## Flux.2 Dev Workflow
+
+<a className="prose"  target='_blank'  href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/templates/image_flux2.json" style={{ display: 'inline-block', backgroundColor: '#0078D6', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold', marginRight: '10px'}}>
+    <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>Download JSON Workflow File</p>
+</a>
+
+<a className="prose"  target='_blank'  href="https://cloud.comfy.org/?template=image_flux2&utm_source=docs" style={{ display: 'inline-block', backgroundColor: '#28a745', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
+    <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>Run on ComfyUI Cloud</p>
+</a>
+
+## Model links
+
+**text_encoders**
+
+- [mistral_3_small_flux2_bf16.safetensors](https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/text_encoders/mistral_3_small_flux2_bf16.safetensors)
+
+**diffusion_models**
+
+- [flux2_dev_fp8mixed.safetensors](https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/diffusion_models/flux2_dev_fp8mixed.safetensors)
+
+**vae**
+
+- [flux2-vae.safetensors](https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/vae/flux2-vae.safetensors)
+
+**Model Storage Location**
+
+```
+📂 ComfyUI/
+├── 📂 models/
+│   ├── 📂 text_encoders/
+│   │      └── mistral_3_small_flux2_bf16.safetensors
+│   ├── 📂 diffusion_models/
+│   │      └── flux2_dev_fp8mixed.safetensors
+│   └── 📂 vae/
+│          └── flux2-vae.safetensors
+```
diff --git a/zh-CN/tutorials/flux/flux-2-dev.mdx b/zh-CN/tutorials/flux/flux-2-dev.mdx
new file mode 100644
index 00000000..667c3b52
--- /dev/null
+++ b/zh-CN/tutorials/flux/flux-2-dev.mdx
@@ -0,0 +1,64 @@
+---
+title: "ComfyUI Flux.2 Dev 示例"
+description: "本文将简要介绍 Flux.2 模型，并指导你在 ComfyUI 中使用 Flux.2 Dev 模型进行文生图。"
+sidebarTitle: "Flux.2 Dev"
+---
+
+import UpdateReminder from '/snippets/zh/tutorials/update-reminder.mdx'
+
+## 关于 FLUX.2
+
+[FLUX.2](https://bfl.ai/blog/flux-2) 是 [Black Forest Labs](https://blackforestlabs.ai/) 推出的下一代图像模型，可生成高达 4MP 的照片级真实输出，在光照、皮肤、织物和手部细节方面有显著提升。它支持可靠的多参考一致性（最多 10 张图像）、改进的编辑精度、更好的视觉理解能力以及专业级的文字渲染。
+
+**主要特点：**
+- **多参考一致性：** 在多个输出中可靠地保持身份、产品几何形状、纹理、材质、服装和构图意图
+- **高分辨率照片级真实感：** 生成高达 4MP 的图像，具有真实世界的光照行为、空间推理和物理感知细节
+- **专业级控制：** 精确的姿势控制、十六进制精确的品牌颜色、任意宽高比以及用于程序化工作流的结构化提示
+- **可用的文字渲染：** 在 UI 界面、信息图表和多语言内容中生成清晰、易读的文字
+
+**可用模型：**
+- **FLUX.2 Dev：** 开源模型（本教程使用）
+- **FLUX.2 Pro：** Black Forest Labs 的 API 版本
+
+<Note>
+本工作流使用量化权重。原始 FLUX.2 仓库可在[此处](https://huggingface.co/black-forest-labs/FLUX.2-dev/)获取。
+</Note>
+
+<UpdateReminder/>
+
+## Flux.2 Dev 工作流
+
+<a className="prose"  target='_blank'  href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/templates/image_flux2.json" style={{ display: 'inline-block', backgroundColor: '#0078D6', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold', marginRight: '10px'}}>
+    <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>下载 JSON 工作流文件</p>
+</a>
+
+<a className="prose"  target='_blank'  href="https://cloud.comfy.org/?template=image_flux2&utm_source=docs" style={{ display: 'inline-block', backgroundColor: '#28a745', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
+    <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>在 ComfyUI Cloud 上运行</p>
+</a>
+
+## 模型链接
+
+**text_encoders**
+
+- [mistral_3_small_flux2_bf16.safetensors](https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/text_encoders/mistral_3_small_flux2_bf16.safetensors)
+
+**diffusion_models**
+
+- [flux2_dev_fp8mixed.safetensors](https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/diffusion_models/flux2_dev_fp8mixed.safetensors)
+
+**vae**
+
+- [flux2-vae.safetensors](https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/vae/flux2-vae.safetensors)
+
+**模型存储位置**
+
+```
+📂 ComfyUI/
+├── 📂 models/
+│   ├── 📂 text_encoders/
+│   │      └── mistral_3_small_flux2_bf16.safetensors
+│   ├── 📂 diffusion_models/
+│   │      └── flux2_dev_fp8mixed.safetensors
+│   └── 📂 vae/
+│          └── flux2-vae.safetensors
+```