mirror of
https://github.com/langgenius/dify-docs.git
synced 2026-03-26 13:18:34 +07:00
add the publish to marketplace doc (#700)
This commit is contained in:
149
en/use-dify/publish/publish-to-marketplace.mdx
Normal file
149
en/use-dify/publish/publish-to-marketplace.mdx
Normal file
@@ -0,0 +1,149 @@
|
||||
---
|
||||
title: Publish Apps to Marketplace
|
||||
sidebarTitle: Marketplace
|
||||
description: Publish your apps to Dify Marketplace and share them with the world
|
||||
icon: store
|
||||
---
|
||||
|
||||
Publish your apps as templates to Dify Marketplace, where other Dify users can discover and use them.
|
||||
|
||||
## Submit Templates
|
||||
|
||||
To publish a template, submit it for review first. Once approved, it will be listed on Marketplace.
|
||||
|
||||
<Note>
|
||||
Before submission, make sure all plugins used in the app are **installed directly from Marketplace**.
|
||||
</Note>
|
||||
|
||||
There are two ways to submit:
|
||||
|
||||
<Tabs>
|
||||
<Tab title="From Dify Studio">
|
||||
<Info>
|
||||
Available in [beta](https://github.com/langgenius/dify/releases/tag/1.14.0-rc1) environment only.
|
||||
</Info>
|
||||
In your app, click **Publish** > **Publish to Marketplace**.
|
||||
|
||||
This takes you to the [Creator Center](https://creators.dify.ai) where you can fill in the template details and submit for review.
|
||||
</Tab>
|
||||
|
||||
<Tab title="In the Creator Center">
|
||||
Export your app, then go to the [Creator Center](https://creators.dify.ai) and upload the export file. Fill in the template details and submit for review.
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## Template Writing Guidelines
|
||||
|
||||
### Language Requirements
|
||||
|
||||
Keep the template library consistent and searchable.
|
||||
|
||||
**The following fields must be written in English**:
|
||||
|
||||
- Template name
|
||||
- Overview
|
||||
- Setup steps
|
||||
|
||||
**Inside the app, you can use any language (e.g. Chinese) for**:
|
||||
|
||||
- Node names
|
||||
- Prompts / system messages
|
||||
- Messages shown to end-users
|
||||
|
||||
If your template mainly targets non-English users, you can add a tag in the title. For example,
|
||||
`Stock Investment Analysis Copilot [ZH]`.
|
||||
|
||||
### Template Name & Icon
|
||||
|
||||
From the name alone, users should know where it runs and what it does.
|
||||
|
||||
- Use a short English phrase, typically 3-7 words.
|
||||
- Recommended pattern: [Channel / target] + [core task], for example:
|
||||
- WeChat Customer Support Bot
|
||||
- CSV Data Analyzer with Natural Language
|
||||
- Internal Docs Q&A Assistant
|
||||
- GitHub Issue Triage Agent
|
||||
- Include keywords users might search for: channel names (Slack, WeChat, Email, Notion) and task names (Summarizer, Assistant, Generator, Bot).
|
||||
|
||||
### Categories
|
||||
|
||||
Help users discover your template when browsing or filtering by category.
|
||||
|
||||
- Select only **1-3** categories that best describe your template.
|
||||
- Do not check every category just for exposure.
|
||||
|
||||
### Language
|
||||
|
||||
Help users discover your template via language filters.
|
||||
|
||||
- Select the language(s) your template is designed for in real usage.
|
||||
- This refers to the language of the template's use case, input, or output — **not** the title or overview (which must be in English).
|
||||
|
||||
### Overview
|
||||
|
||||
In 2-4 English sentences, explain what it does and who it is for.
|
||||
|
||||
<Info>You don't need to list prerequisites, inputs, or outputs here.</Info>
|
||||
|
||||
**Recommended structure**
|
||||
|
||||
1. Sentence 1: **What it does**
|
||||
|
||||
A one-sentence summary of the main function.
|
||||
2. Sentence 2-3: **Who and when**
|
||||
|
||||
Typical user roles or scenarios (support team, marketers, founders, individual knowledge workers, etc.).
|
||||
|
||||
<Accordion title="Example: Description for Stock Investment Analysis Copilot">
|
||||
This template creates a stock investment analysis copilot that uses Yahoo Finance tools to fetch news, analytics, and ticker data for any listed company.
|
||||
|
||||
It helps investors and analysts quickly generate structured research summaries, compare companies, and prepare reports without manually switching between multiple finance websites.
|
||||
</Accordion>
|
||||
|
||||
### Setup Steps
|
||||
|
||||
Write Setup steps as a numbered Markdown list (1., 2., 3.), with one short sentence per step, starting with a verb.
|
||||
|
||||
A new user should be able to get the template running in a few minutes just by following these steps.
|
||||
|
||||
**Writing principles**
|
||||
|
||||
1. Follow the real setup order, usually:
|
||||
1. Use/import the template
|
||||
2. Connect accounts / add API keys
|
||||
3. Connect data sources (docs, databases, sheets, etc.)
|
||||
4. Optional customization (assistant name, tone, filters)
|
||||
5. Activate the workflow and run a test
|
||||
|
||||
2. Each step should answer:
|
||||
- Where to click in the UI
|
||||
- What to configure or fill in
|
||||
|
||||
3. Aim for 3-8 steps. Too few feels incomplete; too many feels overwhelming.
|
||||
|
||||
<Accordion title="Example: Setup Steps for Stock Investment Analysis Copilot (Yahoo Finance tools) ">
|
||||
1. Click **Use template** to copy the “Investment Analysis Copilot (Yahoo Finance)” agent into your workspace.
|
||||
|
||||
2. Go to **Settings → Model provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider.
|
||||
|
||||
3. Open the agent's **Orchestrate** page and make sure the Yahoo Finance tools are enabled in the **Tools** section:
|
||||
- `yahoo Analytics`
|
||||
- `yahoo News`
|
||||
- `yahoo Ticker`
|
||||
|
||||
4. (Optional) Customize the analysis style:
|
||||
- In the **INSTRUCTIONS** area, adjust the system prompt to match your target users. For example, tone, report length, preferred language, or risk preference.
|
||||
- Update the suggested questions in the **Debug & Preview** panel if you want different example queries.
|
||||
|
||||
5. Click **Publish** to make the agent available, then use the preview panel to test it:
|
||||
- Enter a company name or ticker (e.g., `Nvidia`, `AAPL`, `TSLA`).
|
||||
- Confirm that the copilot calls the Yahoo Finance tools and returns a structured investment analysis report.
|
||||
</Accordion>
|
||||
|
||||
### Quick Checklist Before You Submit
|
||||
|
||||
- The name is a short English phrase that clearly shows where it runs and what it does.
|
||||
- The overview uses 2-4 English sentences to explain the value and typical use cases.
|
||||
- Only 1-3 relevant categories are selected.
|
||||
- Setup steps are a clear numbered list.
|
||||
- Internal workflow texts and prompts are written in appropriate languages for your target users.
|
||||
Reference in New Issue
Block a user