From 58e8658c41a9b1156af08b23a446606fbac67ee4 Mon Sep 17 00:00:00 2001 From: Nav Singh Date: Mon, 24 Aug 2026 13:11:46 -0700 Subject: [PATCH] docs: sharpen search metadata on the highest-traffic installation and basics pages Rewrites filler and too-short frontmatter descriptions on the pages search and AI assistants actually land on (PostHog, last 30 days: installation/desktop/windows gets more entries from ChatGPT than from Google and sends 8k+ clicks to comfy.org; comfyui_portable_windows is the most LLM-referred docs page). Also fixes an inaccurate description on the Wan2.1 tutorial, removes a markdown link embedded in the changelog description, drops em dashes from four titles per the repo prose rules, and converts three statement H2s on the basics tutorials to question format with {#custom-id} pins preserving existing anchors. --- changelog/index.mdx | 2 +- installation/comfyui_portable_windows.mdx | 4 ++-- installation/desktop/macos.mdx | 4 ++-- installation/desktop/windows.mdx | 4 ++-- installation/install_custom_node.mdx | 2 +- installation/manual_install.mdx | 4 ++-- installation/update_comfyui.mdx | 2 +- manager/install.mdx | 2 +- tutorials/basic/image-to-image.mdx | 4 ++-- tutorials/basic/lora.mdx | 2 +- tutorials/basic/text-to-image.mdx | 6 +++--- tutorials/basic/upscale.mdx | 2 +- tutorials/video/wan/wan-video.mdx | 2 +- tutorials/video/wan/wan2_2.mdx | 2 +- 14 files changed, 21 insertions(+), 21 deletions(-) diff --git a/changelog/index.mdx b/changelog/index.mdx index 2426917db..8f7d8eda0 100644 --- a/changelog/index.mdx +++ b/changelog/index.mdx @@ -1,6 +1,6 @@ --- title: "Changelog" -description: "Track ComfyUI's latest features, improvements, and bug fixes. For detailed release notes, see the [Github releases](https://github.com/Comfy-Org/ComfyUI/releases) page." +description: "ComfyUI changelog: the latest features, improvements, and bug fixes in each release, updated as new versions ship." icon: "clock-rotate-left" --- diff --git a/installation/comfyui_portable_windows.mdx b/installation/comfyui_portable_windows.mdx index b79d76a10..57b3434ed 100644 --- a/installation/comfyui_portable_windows.mdx +++ b/installation/comfyui_portable_windows.mdx @@ -1,6 +1,6 @@ --- -title: "ComfyUI(portable) Windows — Local Self-Hosted" -description: "This tutorial will guide you on how to download and start using ComfyUI Portable and run the corresponding programs" +title: "ComfyUI Portable for Windows" +description: "Download and run ComfyUI Portable on Windows: a standalone package with embedded Python and CUDA builds for Nvidia GPUs. Extract it and start creating." icon: "box" sidebarTitle: "Portable (Local)" --- diff --git a/installation/desktop/macos.mdx b/installation/desktop/macos.mdx index d5f1b2417..779cebae9 100644 --- a/installation/desktop/macos.mdx +++ b/installation/desktop/macos.mdx @@ -1,6 +1,6 @@ --- -title: "macOS — Comfy Desktop" -description: "Install and uninstall Comfy Desktop on macOS" +title: "Comfy Desktop for macOS" +description: "Install Comfy Desktop on macOS: system requirements, setup steps, updates, and a clean uninstall for running ComfyUI locally on Apple silicon Macs." icon: "apple" sidebarTitle: "macOS" --- diff --git a/installation/desktop/windows.mdx b/installation/desktop/windows.mdx index 0ba230870..eb9c129c3 100644 --- a/installation/desktop/windows.mdx +++ b/installation/desktop/windows.mdx @@ -1,6 +1,6 @@ --- -title: "Windows — Comfy Desktop" -description: "Install and uninstall Comfy Desktop on Windows" +title: "Comfy Desktop for Windows" +description: "Install Comfy Desktop on Windows: system requirements, setup steps, updates, and a clean uninstall for running ComfyUI locally on Windows 10 and later." icon: "windows" sidebarTitle: "Windows" --- diff --git a/installation/install_custom_node.mdx b/installation/install_custom_node.mdx index f7daf40b1..ab4739664 100644 --- a/installation/install_custom_node.mdx +++ b/installation/install_custom_node.mdx @@ -1,6 +1,6 @@ --- title: "How to Install Custom Nodes in ComfyUI" -description: "This guide will show you different methods to install custom nodes in ComfyUI" +description: "Install custom nodes in ComfyUI with ComfyUI Manager, git clone, or a ZIP download, and install their Python dependencies safely." sidebarTitle: "Custom nodes" icon: "puzzle-piece" --- diff --git a/installation/manual_install.mdx b/installation/manual_install.mdx index ee25ed068..6291261b0 100644 --- a/installation/manual_install.mdx +++ b/installation/manual_install.mdx @@ -1,6 +1,6 @@ --- -title: "Manual Installation — Local Self-Hosted" -description: "This section will guide you through the manual installation process on Windows, MacOS and Linux" +title: "Install ComfyUI Manually (Windows, macOS, Linux)" +description: "Install ComfyUI manually on Windows, macOS, or Linux: create a virtual environment, clone the repository, install GPU dependencies, and start the app." icon: "wrench" sidebarTitle: "Manual (Local)" --- diff --git a/installation/update_comfyui.mdx b/installation/update_comfyui.mdx index c903d78e3..dd8ed78d6 100644 --- a/installation/update_comfyui.mdx +++ b/installation/update_comfyui.mdx @@ -1,6 +1,6 @@ --- title: "How to Update ComfyUI" -description: "This section provides a comprehensive guide to updating ComfyUI" +description: "Update ComfyUI on any install type: Portable update scripts, Desktop updates, and git pull for manual installs, plus fixes for common update issues." icon: "circle-up" sidebarTitle: "Update ComfyUI" --- diff --git a/manager/install.mdx b/manager/install.mdx index b7b48f768..ff991ab48 100644 --- a/manager/install.mdx +++ b/manager/install.mdx @@ -1,7 +1,7 @@ --- title: ComfyUI-Manager Installation sidebarTitle: Install -description: How to install ComfyUI-Manager for different setups +description: Install ComfyUI-Manager on Desktop, Portable, or manual ComfyUI setups to search, install, and update custom nodes from inside the app. --- ## Desktop users diff --git a/tutorials/basic/image-to-image.mdx b/tutorials/basic/image-to-image.mdx index 4c0ba774b..293896ac9 100644 --- a/tutorials/basic/image-to-image.mdx +++ b/tutorials/basic/image-to-image.mdx @@ -1,10 +1,10 @@ --- title: "ComfyUI Image to Image Workflow" sidebarTitle: "Image to Image" -description: "This guide will help you understand and complete an image to image workflow" +description: "Build an image-to-image workflow in ComfyUI: load a reference image and generate new versions in a different style, from line art, or restored." --- -## What is Image to Image +## What is image-to-image in ComfyUI? {#what-is-image-to-image} Image to Image is a workflow in ComfyUI that allows users to input an image and generate a new image based on it. diff --git a/tutorials/basic/lora.mdx b/tutorials/basic/lora.mdx index dff20e462..24f4d4d0d 100644 --- a/tutorials/basic/lora.mdx +++ b/tutorials/basic/lora.mdx @@ -1,7 +1,7 @@ --- title: "ComfyUI LoRA Example" sidebarTitle: "LoRA" -description: "This guide will help you understand and use a single LoRA model" +description: "Use LoRA models in ComfyUI: install a LoRA, load it with the Load LoRA node, and run a workflow that applies its style on top of a checkpoint." --- **LoRA (Low-Rank Adaptation)** is an efficient technique for fine-tuning large generative models like Stable Diffusion. diff --git a/tutorials/basic/text-to-image.mdx b/tutorials/basic/text-to-image.mdx index 6f22f91ec..e6a1f8a87 100644 --- a/tutorials/basic/text-to-image.mdx +++ b/tutorials/basic/text-to-image.mdx @@ -1,6 +1,6 @@ --- title: "ComfyUI Text to Image Workflow" -description: "This guide will help you understand the concept of text-to-image in AI art generation and complete a text-to-image workflow in ComfyUI" +description: "Build a text-to-image workflow in ComfyUI: load the default workflow, install an SD1.5 checkpoint, write prompts, and learn what each node does." sidebarTitle: "Text to Image" --- @@ -14,7 +14,7 @@ In this document, we will: We'll start by running a text-to-image workflow, followed by explanations of related concepts. Please choose the relevant sections based on your needs. -## About Text to Image +## What is text-to-image in ComfyUI? {#about-text-to-image} **Text to Image** is a fundamental process in AI art generation that creates images from text descriptions, with **diffusion models** at its core. @@ -119,7 +119,7 @@ Negative prompts: blurry, low detail, cartoonish, unrealistic anatomy, out of focus, cluttered, flat lighting ``` -## Text to Image Working Principles +## How does text-to-image work? {#text-to-image-working-principles} The entire text-to-image process can be understood as a **reverse diffusion process**. The [v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors) we downloaded is a pre-trained model that can **generate target images from pure Gaussian noise**. We only need to input our prompts, and it can generate target images through denoising random noise. diff --git a/tutorials/basic/upscale.mdx b/tutorials/basic/upscale.mdx index c0545d6ac..17a39a7fe 100644 --- a/tutorials/basic/upscale.mdx +++ b/tutorials/basic/upscale.mdx @@ -1,6 +1,6 @@ --- title: "ComfyUI Image Upscale Workflow" -description: "This guide explains the concept of image upscaling in AI drawing and demonstrates how to implement an image upscaling workflow in ComfyUI" +description: "Upscale images in ComfyUI: load an upscale model, build the workflow, and chain it after text-to-image for higher resolution outputs." sidebarTitle: "Upscale" --- diff --git a/tutorials/video/wan/wan-video.mdx b/tutorials/video/wan/wan-video.mdx index 42fe2b1ea..3dedd4ac8 100644 --- a/tutorials/video/wan/wan-video.mdx +++ b/tutorials/video/wan/wan-video.mdx @@ -1,6 +1,6 @@ --- title: "ComfyUI Wan2.1 Video Examples" -description: "This guide demonstrates how to generate videos with first and last frames using Wan2.1 Video in ComfyUI" +description: "Run Wan2.1 video workflows in ComfyUI: text-to-video with the 1.3B model and image-to-video with the 14B model, including model installation." sidebarTitle: "Wan2.1" --- diff --git a/tutorials/video/wan/wan2_2.mdx b/tutorials/video/wan/wan2_2.mdx index 99795c31a..76ab8a66b 100644 --- a/tutorials/video/wan/wan2_2.mdx +++ b/tutorials/video/wan/wan2_2.mdx @@ -1,6 +1,6 @@ --- title: "Wan2.2 Video Generation ComfyUI Official Native Workflow Example" -description: "Official usage guide for Alibaba Cloud Tongyi Wanxiang 2.2 video generation model in ComfyUI" +description: "Run Wan2.2 video workflows in ComfyUI: the 5B hybrid TI2V model plus 14B text-to-video, image-to-video, and first-last-frame examples, with downloads." sidebarTitle: Wan2.2 ---