Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dify.ai/llms.txt

Use this file to discover all available pages before exploring further.

A .difypkg is the portable form of a Dify plugin. Once you have one, anyone can install it through the Plugins page by uploading the file. This is the right path for private plugins, internal testing, or out-of-band distribution to a small group. For wider distribution, see the Publishing Overview.

​
Prerequisites

The author field in manifest.yaml and every provider/*.yaml must match your GitHub handle. Mismatches cause plugin_unique_identifier is not valid at install time. See General Specifications for the full manifest spec.

​
Package the plugin

1

Move above the project

Navigate to the directory above your plugin project (so the project is a subdirectory of the current working directory).
2

Run the packager

dify plugin package ./your_plugin_project
The CLI produces a your_plugin_project.difypkg file in the current directory.
Generated Plugin File

​
Install from the file

1

Open the Plugins page

In Dify, click the Plugins icon in the top-right corner.
2

Choose Install Plugin > Via Local File

Or drag the .difypkg onto the empty area of the Plugins page.
3

Confirm the install

Review the permissions the plugin requests, then click Install.
Install Plugin File
The plugin is now in the workspace and ready to use in Agents, Workflows, or Tools. No further action required.
Self-hosted Dify enforces signature verification by default. Unsigned .difypkg files installed via Local File will be rejected unless you sign them or change the verification setting. See Third-Party Signature Verification.

​
Share the file

Hand the .difypkg file to your users directly, over email, internal file share, or any channel you control. They install it with the same flow above. If you want broader distribution instead, consider:

Publish on GitHub

Attach the .difypkg to a GitHub release; users install via repo URL.

Submit to Marketplace

Open a PR against langgenius/dify-plugins for the official catalog.
Edit this page | Report an issue