Skip to content

Commit 583f99c

Browse files
committed
docs: document marketplace template status and update flow (#802)
(cherry picked from commit 10148a4)
1 parent b6351a4 commit 583f99c

3 files changed

Lines changed: 71 additions & 38 deletions

File tree

en/use-dify/publish/publish-to-marketplace.mdx

Lines changed: 29 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,11 @@ description: Publish your apps to Dify Marketplace and share them with the world
66

77
Publish your apps as templates to Dify Marketplace, where other Dify users can discover and use them.
88

9-
## Submit Templates
9+
## Submit a Template
1010

11-
To publish a template, submit it through the [Creator Center](https://creators.dify.ai) for review. Once approved, it will be listed on Marketplace.
11+
To publish a template, submit it through the [Creator Center](https://creators.dify.ai). After you submit, the template enters **Pending** status while we review it. Once approved, it's published to Marketplace.
1212

13-
While your template is pending review, you can withdraw it anytime to make changes and resubmit.
13+
While a template is **Pending**, you can withdraw it at any time. Withdrawing returns it to **Draft**, where you can edit any part of the template before resubmitting.
1414

1515
<Note>
1616
Before submission:
@@ -35,14 +35,26 @@ You can switch between your personal account and organizations anytime.
3535

3636
In your app, click **Publish** > **Publish Update**, then click **Publish to Marketplace**.
3737

38-
This takes you to the Creator Center with your app file automatically uploaded — just fill in the template details and submit for review.
38+
This takes you to the Creator Center with your app file automatically uploaded. Just fill in the template details and submit for review.
3939
</Tab>
4040

4141
<Tab title="In the Creator Center">
4242
Export your app, then go to the Creator Center and upload the export file. Fill in the template details and submit for review.
4343
</Tab>
4444
</Tabs>
4545

46+
## Update a Published Template
47+
48+
How you update a published template depends on what you want to change.
49+
50+
- **To change anything inside the app** (its prompts, tools, model settings, and so on)
51+
52+
Submit the updated app as a new template. This creates a separate listing rather than replacing the original, so you can manually unpublish the old version once the new one is published.
53+
54+
- **To change only the listing** (such as the Overview or Setup steps)
55+
56+
Unpublish the template to take it off Marketplace and return it to **Draft**. Make your edits, then resubmit for review.
57+
4658
## Template Writing Guidelines
4759

4860
### Language Requirements
@@ -61,14 +73,13 @@ Keep the template library consistent and searchable.
6173
- Prompts / system messages
6274
- Messages shown to end-users
6375

64-
If your template mainly targets non-English users, you can add a tag in the title. For example,
65-
`Stock Investment Analysis Copilot [ZH]`.
76+
If your template mainly targets non-English users, you can add a tag in the title. For example, `Stock Investment Analysis Copilot [ZH]`.
6677

6778
### Template Name & Icon
6879

6980
From the name alone, users should know where it runs and what it does.
7081

71-
- Use a short English phrase, typically 3-7 words.
82+
- Use a short English phrase, typically 37 words.
7283
- Recommended pattern: [Channel / target] + [core task], for example:
7384
- WeChat Customer Support Bot
7485
- CSV Data Analyzer with Natural Language
@@ -81,19 +92,19 @@ From the name alone, users should know where it runs and what it does.
8192

8293
Help users discover your template when browsing or filtering by category.
8394

84-
- Select only **1-3** categories that best describe your template.
95+
- Select only **13** categories that best describe your template.
8596
- Do not check every category just for exposure.
8697

8798
### Language
8899

89-
Help users discover your template via language filters.
100+
Help users discover your template via the language filter.
90101

91-
- Select the language(s) your template is designed for in real usage.
92-
- This refers to the language of the template's use case, input, or output**not** the title or overview (which must be in English).
102+
- Select the language your template is designed for in real usage.
103+
- This refers to the language of the template's use case, input, or output, not the title or overview (which must be in English).
93104

94105
### Overview
95106

96-
In 2-4 English sentences, explain what it does and who it is for.
107+
In 24 English sentences, explain what it does and who it is for.
97108

98109
<Info>You don't need to list prerequisites, inputs, or outputs here.</Info>
99110

@@ -102,7 +113,7 @@ In 2-4 English sentences, explain what it does and who it is for.
102113
1. Sentence 1: **What it does**
103114

104115
A one-sentence summary of the main function.
105-
2. Sentence 2-3: **Who and when**
116+
2. Sentence 23: **Who and when**
106117

107118
Typical user roles or scenarios (support team, marketers, founders, individual knowledge workers, etc.).
108119

@@ -131,12 +142,12 @@ A new user should be able to get the template running in a few minutes just by f
131142
- Where to click in the UI
132143
- What to configure or fill in
133144

134-
3. Aim for 3-8 steps. Too few feels incomplete; too many feels overwhelming.
145+
3. Aim for 38 steps. Too few feels incomplete; too many feels overwhelming.
135146

136-
<Accordion title="Example: Setup Steps for Stock Investment Analysis Copilot (Yahoo Finance tools) ">
147+
<Accordion title="Example: Setup Steps for Stock Investment Analysis Copilot (Yahoo Finance tools)">
137148
1. Click **Use template** to copy the "Investment Analysis Copilot (Yahoo Finance)" agent into your workspace.
138149

139-
2. Go to **SettingsModel provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider.
150+
2. Go to **Settings** > **Model Provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider.
140151

141152
3. Open the agent's **Orchestrate** page and make sure the Yahoo Finance tools are enabled in the **Tools** section:
142153
- `yahoo Analytics`
@@ -155,7 +166,7 @@ A new user should be able to get the template running in a few minutes just by f
155166
### Quick Checklist Before You Submit
156167

157168
- The name is a short English phrase that clearly shows where it runs and what it does.
158-
- The overview uses 2-4 English sentences to explain the value and typical use cases.
159-
- Only 1-3 relevant categories are selected.
169+
- The overview uses 24 English sentences to explain the value and typical use cases.
170+
- Only 13 relevant categories are selected.
160171
- Setup steps are a clear numbered list.
161172
- Internal workflow texts and prompts are written in appropriate languages for your target users.

ja/use-dify/publish/publish-to-marketplace.mdx

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ description: "アプリを Dify マーケットプレイスに公開して世界
1010

1111
## テンプレートの提出
1212

13-
テンプレートを公開するには、[クリエイターセンター](https://creators.dify.ai)から審査に提出します。承認されると、マーケットプレイスに掲載されます
13+
テンプレートを公開するには、[クリエイターセンター](https://creators.dify.ai) から提出します。提出後、テンプレートは **Pending** ステータスになります。承認されると、マーケットプレイスに公開されます
1414

15-
テンプレートが審査待ちの間、いつでも取り下げて修正し、再提出できます
15+
テンプレートが **Pending** の間は、いつでも取り下げられます。取り下げるとテンプレートは **Draft** に戻り、任意の部分を編集してから再提出できます
1616

1717
<Note>
1818
提出前に:
@@ -44,6 +44,18 @@ description: "アプリを Dify マーケットプレイスに公開して世界
4444
</Tab>
4545
</Tabs>
4646

47+
## 公開済みテンプレートの更新
48+
49+
公開済みテンプレートの更新方法は、変更内容によって異なります。
50+
51+
- **アプリ本体を変更する場合**(プロンプト、ツール、モデル設定など)
52+
53+
更新したアプリを新しいテンプレートとして提出します。これは既存のテンプレートを置き換えるのではなく、別のテンプレートとして作成されます。新しいテンプレートの公開後、古いバージョンは手動で非公開にできます。
54+
55+
- **掲載内容のみを変更する場合**(概要やセットアップ手順など)
56+
57+
テンプレートを非公開にして **Draft** に戻し、編集してから再提出します。
58+
4759
## テンプレート作成ガイドライン
4860

4961
### 言語の要件
@@ -62,8 +74,7 @@ description: "アプリを Dify マーケットプレイスに公開して世界
6274
- プロンプト / システムメッセージ
6375
- エンドユーザーに表示されるメッセージ
6476

65-
テンプレートが主に英語以外のユーザーを対象とする場合は、タイトルにタグを追加できます。例えば、
66-
`Stock Investment Analysis Copilot [JA]`
77+
テンプレートが主に英語以外のユーザーを対象とする場合は、タイトルにタグを追加できます。例えば、`Stock Investment Analysis Copilot [JA]`
6778

6879
### テンプレート名とアイコン
6980

@@ -90,7 +101,7 @@ description: "アプリを Dify マーケットプレイスに公開して世界
90101
ユーザーが言語フィルターでテンプレートを発見しやすくします。
91102

92103
- テンプレートが実際の利用で対象とする言語を選択します。
93-
- これはテンプレートのユースケース、入力、または出力の言語を指します——タイトルや概要の言語(英語必須)では**ありません**
104+
- これはテンプレートのユースケース、入力、または出力の言語を指しますタイトルや概要の言語(英語必須)では **ありません**
94105

95106
### 概要
96107

@@ -137,7 +148,7 @@ description: "アプリを Dify マーケットプレイスに公開して世界
137148
<Accordion title="例:Stock Investment Analysis Copilot(Yahoo Finance ツール)のセットアップ手順">
138149
1. Click **Use template** to copy the "Investment Analysis Copilot (Yahoo Finance)" agent into your workspace.
139150

140-
2. Go to **SettingsModel provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider.
151+
2. Go to **Settings** > **Model Provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider.
141152

142153
3. Open the agent's **Orchestrate** page and make sure the Yahoo Finance tools are enabled in the **Tools** section:
143154
- `yahoo Analytics`

zh/use-dify/publish/publish-to-marketplace.mdx

Lines changed: 25 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ description: "将你的应用发布到 Dify 市场,与全世界分享"
1010

1111
## 提交模板
1212

13-
若要发布模板,请通过[创作者中心](https://creators.dify.ai)提交审核。通过后,模板将在市场上架
13+
若要发布模板,请通过 [创作者中心](https://creators.dify.ai) 提交。提交后,模板进入 **Pending** 状态。通过审核后,即可发布到市场
1414

15-
模板在等待审核期间,你可以随时撤回以进行修改并重新提交
15+
模板处于 **Pending** 状态时,可随时撤回。撤回后,模板将回到 **Draft** 状态,你可修改任意内容后重新提交
1616

1717
<Note>
1818
提交前:
@@ -36,14 +36,26 @@ description: "将你的应用发布到 Dify 市场,与全世界分享"
3636
<Tab title="从 Dify Studio">
3737
在应用内部,点击 **发布** > **发布更新**,然后点击 **发布到市场**
3838

39-
这将跳转到创作者中心,应用文件会自动上传——只需填写模板详情并提交审核。
39+
这将跳转到创作者中心,应用文件会自动上传只需填写模板详情并提交审核。
4040
</Tab>
4141

4242
<Tab title="从创作者中心">
4343
导出你的应用,然后前往创作者中心上传导出文件。填写模板详情并提交审核。
4444
</Tab>
4545
</Tabs>
4646

47+
## 更新已发布的模板
48+
49+
更新已发布的模板时,具体方法取决于你要修改的内容。
50+
51+
- **修改应用本身**(如提示词、工具、模型设置等)
52+
53+
将更新后的应用作为新模板提交。这会生成一个独立的模板,而非替换原有模板;新模板发布后,你可手动下架旧版本。
54+
55+
- **仅修改展示内容**(如概述或设置步骤)
56+
57+
将模板下架,使其回到 **Draft** 状态,然后修改内容并重新提交审核。
58+
4759
## 模板填写指南
4860

4961
### 语言要求
@@ -62,14 +74,13 @@ description: "将你的应用发布到 Dify 市场,与全世界分享"
6274
- 提示词 / 系统消息
6375
- 展示给终端用户的消息
6476

65-
如果你的模板主要面向非英语用户,可以在标题中添加标签。例如,
66-
`Stock Investment Analysis Copilot [ZH]`
77+
如果你的模板主要面向非英语用户,可在标题中添加标签。例如,`Stock Investment Analysis Copilot [ZH]`
6778

6879
### 模板名称和图标
6980

7081
仅从名称,用户就应该知道它在哪里运行以及做什么。
7182

72-
- 使用简短的英文短语,通常为 3-7 个单词。
83+
- 使用简短的英文短语,通常为 37 个单词。
7384
- 推荐模式:[渠道 / 目标] + [核心任务],例如:
7485
- WeChat Customer Support Bot
7586
- CSV Data Analyzer with Natural Language
@@ -82,19 +93,19 @@ description: "将你的应用发布到 Dify 市场,与全世界分享"
8293

8394
帮助用户在浏览或按分类筛选时发现你的模板。
8495

85-
- 仅选择 **1-3** 个最能描述你模板的分类。
96+
- 仅选择 **13** 个最能描述你模板的分类。
8697
- 不要为了增加曝光而勾选所有分类。
8798

8899
### 语言
89100

90101
帮助用户通过语言筛选发现你的模板。
91102

92103
- 选择你的模板在实际使用中所面向的语言。
93-
- 这里指的是模板用例、输入或输出的语言——**而非**标题或概述的语言(这些必须使用英文)。
104+
- 这里指的是模板用例、输入或输出的语言**而非** 标题或概述的语言(这些必须使用英文)。
94105

95106
### 概述
96107

97-
用 2-4 句英文说明它做什么以及面向谁。
108+
用 24 句英文说明它做什么以及面向谁。
98109

99110
<Info>你无需在此列出先决条件、输入或输出。</Info>
100111

@@ -103,7 +114,7 @@ description: "将你的应用发布到 Dify 市场,与全世界分享"
103114
1. 第 1 句:**它做什么**
104115

105116
一句话概括主要功能。
106-
2. 第 2-3 句:**面向谁、什么场景**
117+
2. 第 23 句:**面向谁、什么场景**
107118

108119
典型用户角色或场景(客服团队、营销人员、创始人、个人知识工作者等)。
109120

@@ -132,12 +143,12 @@ description: "将你的应用发布到 Dify 市场,与全世界分享"
132143
- 在界面中点击哪里
133144
- 需要配置或填写什么
134145

135-
3. 目标 3-8 步。太少显得不完整,太多则会令人生畏。
146+
3. 目标 38 步。太少显得不完整,太多则会令人生畏。
136147

137148
<Accordion title="示例:Stock Investment Analysis Copilot (Yahoo Finance) 的设置步骤">
138149
1. Click **Use template** to copy the "Investment Analysis Copilot (Yahoo Finance)" agent into your workspace.
139150

140-
2. Go to **SettingsModel provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider.
151+
2. Go to **Settings** > **Model Provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider.
141152

142153
3. Open the agent's **Orchestrate** page and make sure the Yahoo Finance tools are enabled in the **Tools** section:
143154
- `yahoo Analytics`
@@ -156,7 +167,7 @@ description: "将你的应用发布到 Dify 市场,与全世界分享"
156167
### 提交前快速检查清单
157168

158169
- 名称是一个简短的英文短语,能清楚地说明它在哪里运行、做什么。
159-
- 概述用 2-4 句英文解释价值和典型用例。
160-
- 仅选择了 1-3 个相关分类。
170+
- 概述用 24 句英文解释价值和典型用例。
171+
- 仅选择了 13 个相关分类。
161172
- 设置步骤是清晰的编号列表。
162173
- 工作流内部的文本和提示词使用了面向目标用户的适当语言。

0 commit comments

Comments
 (0)