🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!
Guides & Tutorials October 23, 2026

How to Create wpForo Topics From Gravity Forms Submissions

GravityExtra
How to Create wpForo Topics From Gravity Forms Submissions

wpForo is one of the most used forum plugins for WordPress, and Gravity Forms is one of the most used form builders. It is natural to want them to work together: a person fills in a form on a page of your site and a topic appears in the forum, in the right forum, with the right tags and the right author. This article shows how to do it without copying and pasting, and what to think about before you switch it on.

Why send form submissions to a forum?

Forms are good at collecting structured information. Forums are good at keeping it, discussing it and making it easy to find later. Together they give you a few very practical workflows.

  • Ask the community: a short form on a help page that opens a topic in the Support forum, so visitors do not need to learn the forum before asking.
  • Feature requests: a form with a title, a description and a drop-down that files the idea in the right forum, with a tag for the product.
  • Bug reports: a form with the version, the steps and a severity that becomes a topic your team can filter by tag.
  • Announcements: your team fills in a form in the admin and the news appears as a sticky topic.
  • Answers to a topic: a reply form on a page that adds a reply to a given topic, for example for guest answers in a Q and A.
  • Private topics: a contact form whose answers become a private topic that only the author and the moderators can see.

What wpForo gives a developer

wpForo is a plugin, not a remote service, so there is no API key. Its code has functions to add a topic and to add a post, and they are the same functions its own forms call. They check the forum, the title, the length of the text, the rights of the current user, the flood rules and the moderation rules, and they send the notifications. That is exactly what you want from a form: the form should behave like a member who posts.

It also means a few traps for anyone who tries to write this with a few lines of code. wpForo checks the rights of the current user, which for a form on a public page is nobody. It builds its own objects late in the page load, after Gravity Forms has already handled the form, so a call made too early finds nothing. And it keeps its messages in the session of the visitor, so a refusal can pop up on the next forum page of a stranger. The Gravity Forms wpForo Premium Add-on takes care of these three things.

Step by step: check wpForo and activate the license

  1. Install and activate the free wpForo plugin and create at least one forum in a category.
  2. In WordPress open Forms → Settings → wpForo and activate your license key.
  3. Read the line below it: it names the version of wpForo and the number of forums that the add-on found.
The wpForo settings screen of the add-on: the license section and the line that says wpForo is active with the number of forums found
Forms, Settings, wpForo: the license, and a check that wpForo is active. There is no key to enter.

Step by step: the form and the feed

Build the form as you normally would. A title field, a long text field, a drop-down with the forums, a tags field and a name and e-mail address are enough for most topics.

A Gravity Forms form with a title, a question, a forum choice, a tags field and a name and e-mail address that creates a wpForo topic when it is sent
A plain form. The visitor never sees the feed; it does the posting.

Then open the form settings, choose wpForo and add a feed. Pick Create a topic, choose the forum, use the merge tag of the title field as the title and the merge tag of the long text field as the text, and put the merge tag of the tags field in the tags setting.

The wpForo feed settings: name, action, forum, title with merge tags, tags, the text of the post, options and who posts
A feed: what to post, in which forum, and as whom. Merge tags work in the title, the tags and the text.

If you leave the text empty, the add-on writes every answered field as a bold label followed by its value. That is a quick way to get a readable topic from a longer form, such as a bug report.

Let the visitor choose the forum

You can fix the forum in the feed or let the visitor pick it. For the second case select the form field that holds the choice. Its value can be the forum number or the exact name of the forum. A value that does not match falls back to the forum you chose in the feed, so a typing mistake never loses a submission.

Who should the post come from?

This is the most important choice, because wpForo decides what is allowed by the user who posts. There are four ways.

  • A fixed user. A WordPress user such as a community manager posts every submission. Choose an administrator or a moderator when the post must never be held back by the rules for new members.
  • The logged-in sender. If your visitors are members, the post is theirs, with their name and avatar, and they get the notifications when somebody answers.
  • The user with the e-mail address of the form. Useful when a form is sent by someone who has an account but is not logged in. If there is no match the fixed user posts, or nothing is posted in the strict mode.
  • A guest. The name and the e-mail address of the form are used and the post has no account. wpForo has to allow guests to post in that forum.

The add-on never creates WordPress accounts. Creating accounts from a public form invites abuse, and wpForo has its own registration and approval tools for that.

Let wpForo keep its rules

Because the post goes through wpForo, wpForo can say no. If the posting user may not create topics in the forum you chose, nothing is saved and the entry shows the message from wpForo and a button to post again after you fix the permission. If wpForo thinks the post needs a look, for example the first posts of a new member or a text that repeats the previous one, the topic is saved but not shown, and the entry note says that it waits for moderation. You can also ask for that on purpose with the hold option.

The same entry screen links to the topic and shows the user who posted. Each submission makes one topic per feed. Sending the entry through the feeds again does not make a second one.

Protecting the forum from the form

  • Mentions: a form field can contain the name of a member or a moderator. By default the add-on breaks every @mention so a submission cannot notify people.
  • Markup: what the visitor types is escaped. A script, a frame or a link in the text shows as plain text, and the title is stripped of tags.
  • Numbers: the topic number of a reply and the forum number must be plain numbers. Anything else is refused before wpForo is called.
  • Duplicates: one entry creates one post per feed.
  • Visitor messages: a refusal is read and removed in a private session, so it is not shown to the next visitor of the forum.

Replies instead of topics

Choose Reply to a topic and give the topic number, from a field or a fixed number. The reply is added to the topic and, if you give a post number from the same topic, it answers that post. A closed topic and a topic that does not exist are refused with a clear message.

Using the topic address in the rest of your form

The add-on adds merge tags for the topic address, the topic number, the post number and the user who posted. Use them in the confirmation to send the visitor straight to the topic, in a notification to your team, or in another feed.

A quick checklist before you launch

  1. Check that the forum list in the feed matches your forums and that you chose a forum, not a category.
  2. Send a test submission as a visitor and as a logged-in member and look at who the post comes from.
  3. Try a text with an @mention, a link and a few tags, and see what appears in the forum.
  4. If you use guests, check the rights of the Guest group in the forum.
  5. Read the entry notes. They tell you exactly what happened.
  6. A public form that creates public topics needs a spam check. Gravity Forms has several, and wpForo has its own rules too.

Frequently asked questions

Do I need an API key?

No. The forum is on the same site. The add-on calls wpForo directly.

Does a subscriber of the forum get an e-mail?

Yes. The topic goes through the normal steps of wpForo, so its notifications and subscriptions work.

What about attachments?

Version 1.0.0 posts text. Add the address of an uploaded file to the text with a merge tag when you want a link to it in the topic.

Is anything sent to a third party?

No. Everything stays on your site, and nothing is sent to GravityExtra.

The Gravity Forms wpForo Premium Add-on turns a form submission into a topic or a reply in your wpForo forum, in the forum, with the tags and from the user you choose, and lets wpForo apply its own rules. See the features, the price and the setup guide on the add-on page.

See the wpForo add-on

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr