Repository files navigation

|English |中文 |

To preview documentation changes locally, first install dependencies and then start the development server:

npm inpm run dev

Create a PR. Once it is accepted Vercel will deploy the change tohttps://docs.comfy.org/

Can either use an OpenAPI file or URL containing the file:

cd registry/api-reference# Keep API files separated by products.npx @mintlify/scraping@latest openapi-file<path-to-openapi-file>

This will only generate the MDX files for each endpoint. You need to add a link to these files indocs.json, and the up-to-date API spec will be shown on that doc page.

• Renaming files can cause some external links to become inaccessible, as they are already used in numerous articles and templates.
• Since we can manage the sidebar navigation can be reorganized via the docs.json file, we generally do not change the original document's file location unless absolutely necessary.
• If you renamed any files and caused the file path to be changed, please update theredirects list in thedocs.json

A GitHub Action will check for redirects and fail the PR if they are missing. Redirects should follow this format:

"redirects": [  {"source":"/path/to/old-file","destination":"/path/to/new-file"  }]

Don't forget to include the corresponding Chinese translation file in thezh-CN directory as well!

You can also refer to theMintlify doc to learn how to add and match a wildcard path.

ComfyUI now has a built-in node help menu for both built-in nodes and custom nodes. All built-in node documentation will now be maintained inthis repo.

We will regularly sync updated documentation from the corresponding repository to docs.comfy.org weekly to ensure content synchronization and updates. If you would like to contribute to the documentation, please submit PRs and updates tothis repo.

For node documentation, we will use a single-level directory structure under thebuilt-in-node folder for the following reasons:

• ComfyUI may adjust node categories and directories during updates, using multi-level directory hierarchies means frequent adjustments to node documentation
• These frequent adjustments mean we need to frequently add redirects and checks
• Mintlify supports setting document hierarchy in thedocs.json file, so we can make unified changes in that file

Due to historical updates, some existing documents use different folder hierarchies. We will no longer adjust these files, but new files will use a single-level directory

Please just create a PR and we will review it within a few days.

Or talk to us on ourdiscord

The documentation is built with Mintlify, please refer toMintlify documentation to learn how to use it.

Mintlify uses versioning to add other languages. To add a translation of a page, follow these instructions:

1. Create a file under the language code with the same exact filename of the original English filename.

For example: If you are translatingintroduction.mdx into Chinese, create a file underzh-CN/get_started/introduction.mdx.

Specifications for file editing can be found in the Writing Content section of theMintlify document

Important: When you modify an existing MDX file in the English documentation, you must also update the corresponding file in thezh-CN directory. A GitHub Action will automatically check for this and fail the PR if the corresponding Chinese translations are not updated.

2. Update navigation fordocs.json

Please refer toMintlify Localization for configuration details.

If you translated a single page, just add the new translated page path to the corresponding language navigation group, and it will be displayed in that language version.

Forintroduction.mdx:

  "navigation": {    "languages": [      {        "language": "en",        "groups": [              {                "group": "Get Started",                "pages": [                  "get_started/introduction",                ...                ]              },            ...        ]      },      {        "language": "cn",         "groups": [              {                "group": "开始行动",                "pages": [                  "zh-CN/get_started/introduction",                  ...                ]              }            ]      }    ]    ...  }

Mintlify will automatically determine which pages to display in different language versions based on thelanguage configuration.

Currently, Mintlify supports localization for English (en), Chinese (cn), Spanish (es), French (fr), Japanese (jp), Portuguese (pt), Brazilian Portuguese (pt-BR), and German (de).

For more information, please refer to the Mintlify documentation onMintlify Localization.

If a language doesn't exist yet, for example, if you want to add a French translation ofintroduction.mdx, you should create a newfr-FR folder in the root directory, complete the translation, and then add the following content underlanguages indocs.json:

{  "languages": [    ...    {        "language": "fr",        "groups": [              {                "group": "Get Started",                "pages": [                  "fr-FR/get_started/introduction",                  ...                ]              }          ]      }  ]}

The locale will translate Mintlify default UI components' text. This is optional. The full list of locales arehere.

When adding workflow examples to the documentation, please:

1. Take your output from ComfyUI (PNG, WebP), and add the models urls to the workflow so a user will have them when they drag in the workflow. You can use thistool to edit the metadata of the PNG or WebP file.

1. Upload your workflow JSON and preview image to theexample_workflows repository

2. Use the raw GitHub content URL in your documentation. To convert a GitHub file URL to a raw content URL:

   • Start with your GitHub file URL:

     https://github.com/Comfy-Org/example_workflows/blob/main/your-workflow.json

   • Change it to raw.githubusercontent.com and remove '/blob':

     https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/your-workflow.json

   You can also click the "Raw" button on the GitHub file page and copy the URL directly.

This ensures the workflow metadata is preserved in the docs site when dragging it into ComfyUI.