Creating a link to start a new topic with pre-filled information

[Discourse]

This documentation explains how to create a link that starts a new topic in Discourse with pre-filled information.

Required user level: All users

Sometimes you may want to provide users with a link that opens a new topic composer with certain information pre-filled. This can be useful for various use cases including bug report templates, feature requests, or standardized posts.

Constructing the URL

Base URL

To compose a new pre-filled topic with no extra information, you append /new-topic to your site URL, like so:

https://discourse.example.com/new-topic

Clicking on this will open up a blank new topic composer for any logged-in user (if not logged-in, you’ll be prompted to signin/signup before then opening the composer).

Additional Parameters

While a link to open a blank composer can sometimes be useful, the main strength of this feature is the ability to pre-fill the composer with extra information.

To do this, you can add parameters to the base URL:

https://discourse.example.com/new-topic?title=topic%20title&body=topic%20body&category=category/subcategory&tags=email,planned

This will open a composer window pre-filled with topic title, body, category and tags.

Breaking down the link / URL to show the available options, we have:

• Base URL: https://discourse.example.com/new-topic
• The ? URL operator to add the different options
• Topic title: title=topic%20title
• The &, used each time when including another parameter
• Body: body=topic%20body
• The category and subcategory separated by a slash / if you want to include them: category=category/subcategory
• The tags separated by comma(s) , if you want to include multiple tags: tags=email,planned

Each of the parameters is optional and can be mix and matched depending on your desired end result.

As an alternative to using the category/subcategory name, you can specify a numeric category_id instead, like:

https://meta.discourse.org/new-topic?title=topic%20title&category_id=3

Example

You can try this here on Meta:

https://meta.discourse.org/new-topic?title=topic%20title&body=topic%20body&category=support/wordpress&tags=wordpress

https://meta.discourse.org/new-topic?title=topic%20title&body=topic%20body&category=support/wordpress&tags=wordpress

Though please don’t actually create the topic For a more hands-on explore of the feature use our demo site, try.discourse.org

Using a pre-filled URL with Featured Links

This feature also supports Featured Links, provided that the body parameter is not also included.

The URL must be URL encoded for the link to work.

For example, to create a topic with the following URL https://www.xkcd.com/556, the link will be:

https://meta.discourse.org/new-topic?title=https%3A%2F%2Fwww.xkcd.com%2F556

Best Practices

• w3Schools HTML URL Encoding Reference is a good resource to find what text characters are encoded as in the URL. If you have a lot of text to add, there is also a text-to-URL converter in the ‘Try It Yourself’ section.
• Always URL encode the parameters to avoid issues with special characters.
• If you’re unsure about the category ID, you can check it by looking at the number in the category URL. (eg. https://meta.discourse.org/c/documentation/using-discourse/126)
• Test the pre-filled links to ensure they work as expected.

It is not currently possibly to have a pre-filled link that opens a composer to reply to a specific topic.

Additional Resources

• Creating pre-filled personal message links

[supermathie (Michael Brown)]

ここには多くの技術的な重労働があり、それがこれを凡人には少し受け入れがたいものにしています。人々がこれらのリンクを簡単に生成できる「ヘルパー」ウェブページを作成できると思います。

これに相当するものは、誰かが実装するための気の利いた小さなプロジェクトになるかもしれません。

import urllib

site = 'meta.discourse.org'
title = '''My special checklist'''
category = 'todo'
tags = ['tag1', 'tag2']

template = '''\
# Important!

Do these things:

[ ] thing one
[ ] thing two
'''

query = urllib.parse.urlencode(dict(
    title =    title,
    category = category,
    tags =     ','.join(tags),
    body =     template,
))
print(f'https://{site}/new-topic?{query}')

このリンク を出力します

[MarcP]

@Discourse

たぶん

たぶん* - ドキュメントはウィキだと思っていました

[Moin]

@MarcP

ドキュメントはウィキだと思っていました

これは変更されました

Discourse documentation policy

There are two locations for Discourse documentation - one for official content, created and supported by the Discourse team, and one for community-contributed content. Official documentation Documentation is the home for official Discourse documentation. At Discourse, official documentation means the following: It is written by members of the Discourse team. It can only be edited by members of the Discourse team. It is supported by Discourse. It follows (or will be updated to follow) the doc…

[Moin]

アイデアをありがとうございます！それを見て、Prefilled composer link generator を作成するきっかけになりました。

[supermathie (Michael Brown)]

おお！それは素晴らしい実装のアイデアですね。よくできました！

[fbpbdmin (deepblue)]

質問です。

テーマコンポーネントを実装しました。これにはボタンがあり、クリックするとコンテンツとタイトルがあらかじめ入力された新しいトピックのフォームが開きます。次のようにします。

https://www.mydomain.com/new-topic?title=${title}&body=${body}

これはうまく機能し、新しいトピックのフォームが開きますが、続行したくない場合、「破棄」をクリックすると、トピックは破棄されず、代わりに下書きとして保存されます…「破棄」をクリックしたので、下書きとして保持したくありません。後で下書きをクリーンアップする必要があります。

この new-topic URLを使用すると、これは予期された動作なのでしょうか？破棄を選択した場合に下書きとして保存されないようにする方法はありますか？

ありがとうございます。

再現方法:

1. テーマコンポーネントで、参照を以下のように新しいトピックの URL に設定したボタンを追加します。

const topicBody = `.....`;
const title = "....";

// 新しいトピックの URL
const createTopicUrl = `https://www.mydomain.com/new-topic?title=${title}&body=${topicBody}`;

const createTopicLink = `<span><a href="${createTopicUrl}" rel="noopener noreferrer">new topic</a></span>`;

const meta = `<div>${publisher}${pub_date} ${createTopicLink}</div>`;

const description = `<p>${description}</p>`;

// 「新しいトピック」ボタンを UI に追加
return `<li class="news-item"><hr><div class="news-title"><a href="${url}" target="_blank">${title}</a></div>${meta}${description}</li>`;

2. 「新しいトピック」ボタンをクリックすると、タイトルとコンテンツがあらかじめ入力された新しいトピックのフォームが開きます。
3. 破棄をクリックし、確認します。
4. 「マイ投稿」を確認すると、破棄された新しいトピックの新しい下書きがあります。

[NateDhaliwal]

Metaでは再現できないようです。セーフモードでも発生しますか？お使いのインスタンスのバージョンは何ですか？ありがとうございます。

[fbpbdmin (deepblue)]

私のインスタンスはバージョン 2026.1.0 です。

システムに組み込まれている機能を使用して新しいトピックを作成する場合、破棄すると下書きとして保存されません。

私のケースでは、テーマコンポーネントに追加したボタンに new-topic の URL をフックしました。
組み込みの機能と異なる理由がわかりません…

[fbpbdmin (deepblue)]

やあ、ネイト

Copilotが以下のように説明してくれました。
もしこれが本当なら、これを防ぐためにURLに引数を追加できるか知りたいです。もしできれば素晴らしいです。
&auto_save=false のように指定します。
ご協力ありがとうございます。

はい、それはDiscourseでは想定されている動作です。新しいトピックのURL（タイトル/本文が事前入力された状態）でコンポーザーを開くと、コンポーザーが初期化された時点で下書きが作成されます。「破棄」をクリックして確認した場合でも、Discourseは後でコンテンツを復元できるように、そのルートに対して下書きエントリを保持する場合があります。その動作は、URL形式ではなく、コアのコンポーザー/下書きの自動保存ロジックに由来します。

下書きを避けたい場合は、カスタムアプローチ（例：モーダルを開く、クリップボードにコピーする、またはドラフトキーの上書きを指定してコンポーザーAPIを呼び出す）が必要になりますが、プレーンな新しいトピックのURLは常に下書きの自動保存を有効にします。

[NateDhaliwal]

それが正確かどうかはわかりません 。Metaではセーフモードでこれを再現できません。フォーラムでは安定版/ESRバージョンをご利用でしょうか？

[fbpbdmin (deepblue)]

Nateさん、こんにちは。私もGeminiのその回答には確信が持てません。

興味深いことに、今日はもう再現できなくなりました。私のテーマコンポーネントはその部分に変更がないにもかかわらずです。

ご協力ありがとうございます。さらなる発見があれば投稿します…