Tutorial: Use Gravity Forms to let users submit posts & display them in a table on your website

March 2, 2023

Gravity Forms User Submitted Posts Plugin

As the world's leading WordPress forms plugin, people use Gravity Forms in weird and wonderful ways. Today I'm going to show you how to use Gravity Forms to allow users to add information to your website and submit it to you. You'll learn how to automatically store the data as a WordPress post, WooCommerce product, document (or any other custom post type) and display the Gravity Forms entries in a table on the front end.

The end result will look something like this - a neat table listing your users' form submissions!

Member directory dynamic filters
A WordPress member director listing user-submitted profiles

Why display user-submitted information in the front end?

There are lots of reasons why you might want to let users submit information and display it on your website:

  • WordPress member directory with user profiles If you're using a WordPress member directory plugin to list members or consultants in a table, then you might want to allow people to register and upload a profile. If you don't want to install a heavyweight membership or e-commerce plugin, then it can be simpler to use Gravity Forms for the member registration and profile upload.
  • WordPress directory website If you're creating any type of directory, such as a business or local events directory, then it makes sense for users to submit listings. If you're trying to keep your website simple, then you can avoid installing a full directory theme or plugin by using Gravity Forms and a WordPress table plugin instead. You can even take payment via PayPal and hold submissions for moderation by the administrator before they're published!
  • WooCommerce user-submitted products If you're using WooCommerce then you can let users submit products to sell in your store.
  • User-submitted events If you're using a WordPress events plugin such as The Events Calendar, then your users can submit events to display on your website
  • WordPress document library with user-submitted documents Lots of websites use a WordPress document library plugin to allow users to find and download documents. If you need a way for users to submit their own documents, then you can do this with Gravity Forms. However, unlike the other use cases listed above, there's actually an even simpler option! As an alternative to Gravity Forms, just install the Document Library Pro plugin and use its front-end upload form to let users submit downloadable documents to your site:
demo document library pro
A simpler alternative: Use the Document Library Pro plugin to display user-submitted document downloads.

As you can see, there are loads of reasons to let users upload information which you then display on your website. If you want to display website content rather than downloadable documents, then Gravity Forms is the best solution. Keep reading to see a real-life use case, and then learn how to set it up.

Case study - TV Production Contacts' Job Board

Job detail submission form for TV Production Jobs

TVProductionContacts.com acts as a networking site for TV production professionals, it also hosts a WordPress job board listing jobs available in the industry.

The job board is powered by our Posts Table Pro plugin. The site also uses the Gravity Forms plugin and the Gravity Forms + Custom Post Types add-on to power the job board submission form.

Gravity Forms makes the job board simple to manage. Hiring managers submit all the job details using the form. The user-submitted information is then approved before being automatically displayed in the sortable job board.

Keep reading to find out how to create your own form for users to submit information to your site.

What to expect from this tutorial

This tutorial will teach you how to add the following features to any WordPress website. Read it all, or skip straight to the sections you need:

  1. Use Gravity Forms to collect user-submitted information
  2. Store the information as a WordPress post, document or custom post type
  3. Display the user-submitted data in a table on the front end of your website

You can also watch us setting it up from start to finish in this video:

Step 1 - Use Gravity Forms to collect user-submitted information

The first step is to install the Gravity Forms WordPress plugin and create a form. Your visitors will use this to submit information to you. This is useful whether you want them to upload a document, member profile, business listing, upcoming event, or something else.

  1. First, buy Gravity Forms, download the plugin and install it on your WordPress website (Plugins → Add New).
  2. You'll see a 'Forms' link appear in the left of the WordPress Dashboard. Navigate to Forms → Add New.
  3. Enter a name for your form, then add all the fields. (If you haven't created a form before, please see the official documentation.)
    • Title, content and custom fields - Instead of using Standard and Advanced Fields, you should use Post Fields. These map to fields on your WordPress post type, so that the user data will be stored in the correct place.  
    • Custom taxonomies - Create a Standard Field and then click on the 'Advanced' tab when editing that field. You can use this to map the field to the custom taxonomy on your WordPress post type.
    • If you want users to be able to upload documents via Gravity Forms, use the File Upload field type.
    • Gravity Forms Add User Submitted Listing Form
  4. Click 'Update' to save your form.
  5. Next, create a page (Pages → Add New) and click the 'Add Form' button above the WordPress toolbar if you're using the Classic Editor, or use a Gutenberg block if you're using Gutenberg. Select the form you just created and insert it into the page. You can also add other content to the page:
    Add Gravity Form to Page
  6. Finally, view the page and make sure you're happy with it.

Your user-submitted content page should look something like this:

Gravity Forms User Submitted Content Form

Optional - hide and protect your Gravity Forms page

Some people use Gravity Forms to collect user-submitted content from authorized users only. You can do this by protecting the page containing the form.

There are several ways to do this:

  • The simplest way to secure the Gravity Forms page is to password protect it.
  • If you're using an SEO plugin (e.g. Yoast SEO), then you can also use this to noindex the page. This will ensure it is hidden from search engines.
  • For a more secure approach, use a WordPress membership plugin such as All Access Manager to restrict the page to logged in users with a certain role only.

Step 2 - Store the information as a WordPress post or custom post type

So far, you've learned how to use Gravity Forms to create a form that users can use to submit information to you. It looks pretty, but it's not much use yet! At this stage, the information will be emailed to you and stored in the WordPress database. In Step 2, I'll show you how to automatically use this user-submitted data to create WordPress posts, documents, WooCommerce products, and custom posts. This saves you having to manually input the data to your website.

How to use Gravity Forms to save user-submitted information as a WordPress post

Gravity Wiz have an excellent tutorial about how to save Gravity Forms submissions as posts. Do this, then come back to learn how to display the user-submitted content in a table on the front end.

When you follow the Gravity Wiz tutorial, don't forget to set the 'Status' to draft. This is essential if you want to hold the form submissions for moderation for an administrator to approve before they're published.

How to use Gravity Forms to create a custom post

Storing user-submitted information as normal WordPress posts is fine, but it can clutter up your blog. It's normally better to create a dedicated custom post type for this. For example, if you're creating user-submitted business listings then you can create a 'Business Listings' custom post type. This will add a 'Business Listings' link to the left of the WordPress Dashboard. It's a convenient way to organize the listings, separate from your other website content.

You'll also need to do this if you want to store Gravity Forms entries in a post type created by another plugin. For example, this might be:

  • The 'Documents' post type created by our Document Library Pro plugin.
  • The 'products' post type created by WooCommerce, the 'tribe_events' post type created by the Events Calendar plugin, or any other custom post type.

You'll need a free plugin called Gravity Forms + Custom Post Types for this:

  1. Get the plugin and install it on your WordPress site.
  2. (Optional) If you don't already a custom post type for this purpose, create one now. I recommend the free Pods plugin for this. For full instructions, please see my tutorial about how to create a custom post type, then return here and continue this tutorial.
  3. Use the how-to instructions on the plugin page to map your form fields to the custom post type.

Step 3 - Display user-submitted data in a table on the front end

So far, you've learned how to use Gravity Forms to let users submit information via your website and save it as a post, document or custom post type. The next step is to display the user submitted posts on the front end of your WordPress site. You'll need a dynamic table plugin for this. We have 3 table plugins, so choose the one that lists the type of content that your users will be submitting:

All three plugins list user-submitted information in a searchable, filterable table view. It's the perfect way to display it because each entry is listed in a separate row of the table. Visitors to your website can use the search box to find specific entries, use the filters to refine the list, and sort by any column.

Display WordPress user submitted content posts

How to list user-submitted content in WordPress

  1. Get Posts Table Pro or Document Library Pro and install it on your WordPress website.
  2. Copy your license key from the confirmation page, then enter it on the plugin settings page.
  3. Stay on the settings page, and spend a minute choosing how you want your tables to look and behave.
  4. Next, create a new page. You'll use this to list the user-submitted content from Gravity Forms. Use the plugin documentation to add a table.

Finally, view the page. You'll see all your posts, documents or custom posts (depending on which post type you selected on the plugin settings page) listed in a table on the front end. This is the information that your users have submitted using Gravity Forms. Perfect!

Choosing which items to display

You may wish to add multiple tables to your site, each containing different posts, documents or custom posts. For example, if you're building a WordPress business directory then you might want to display listings from a different business category on each page.

Fortunately, Posts Table Pro and Document Library Pro come with several options for choosing which user-submitted content is listed in the table. You can list items by category, tag, and much more.

File uploads

Gravity Forms comes with a 'Post Image' and ‘File Upload’ field which allow users to upload an image or other file type. There are a couple of ways to display file uploads on the front end with Posts Table Pro and Document Library Pro:

  • If users are uploading images then the easiest option is to add a 'Post Image' field to your Gravity Form and map this to the post/document featured image. You can then display this using the ‘image’ column of the table.
  • If you are using Document Library Pro then you can add the 'File Upload' field to your Gravity Form and use the following snippet to set the document link. Make sure to replace the $form_id and $file_upload_field_id variable values to match the those in the Gravity Form you have created.
    add_action( 'gform_after_create_post', function ( $post_id, $entry, $form ) {
        $form_id = 1; // The ID of your Gravity Form.
        $file_upload_field_id = 6; // The ID of the File Upload field.
        if ( $form_id !== rgar( $form,'id' ) ) {
        $document = dlp_get_document( $post_id );
        $file_url = rgar( $entry, $file_upload_field_id );
        if ( ! $document || ! $file_url ) {
        $document->set_document_link( 'url', [ 'direct_url' => $file_url ] );
    }, 10, 3 );
  • If you are using Posts Table Pro then you can map other file types to a custom field, and display it as a custom field column in the table. Gravity Forms saves the URL of the uploaded file in the WordPress database, and the table plugin will display this as a clickable link when you include it as a column. By itself this may not be ideal, as the link will be very long and won't look very professional. To modify the text inside this link, you can add some code to your site to utilize one of the development filters. For example:
    add_filter( 'posts_table_url_custom_field_text', function ( $link_text, $field_key ) {
        if ( $field_key === 'file_upload' ) {
            return 'Download';
        return $link_text;
    }, 10, 2 );

    In this code snippet, "file_upload" is the 'Custom Field Name' specified in the Gravity Forms custom field, and "Download" is the text that will be displayed to users. Either of these can be updated to fit your circumstances.

If you don’t have a developer who can do this for you then we recommend Codeable.

Can users edit posts after submitting them?

WordPress frontend editor table plugin

Yes, there are two ways that you can allow users to edit the information in the table:

  1. Use Posts Table Pro/Document Library Pro with a front end spreadsheet editor plugin. Add an 'Edit' link above or below the table. Logged in users with the correct role can click this to access a front end spreadsheet editor, which allows them to edit the content of the table. They then save their changes and return to the main table. (Read tutorial.)
  2. Install a WordPress front-end editor plugin such as Editus. People can click through to the single post or document page on your website and edit the information from there. This is important because they can't edit the content from within the table itself. On the single post or document page, they can edit the content as required.

Where to get the plugins

That brings us to the end of our tutorial. You've learned how to use Gravity Forms to allow users to upload information to your website and save it as a post, document or custom post type. You know how to hold these posts for moderation so that they're not published until an administrator approves them. You've discovered the best way to display this information in a table on the front end of your WordPress website. It's the perfect way to create a user-contributed document library, member directory or business listings.

To set it up, you'll need:

I'd love to hear about how you use Gravity Forms for user-submitted content. Do you keep this private or list it on the front end of your website? What sort of data do you collect and display? Please let me know in the comments below.

Get Gravity Forms

Start using Posts Table Pro with Gravity Forms to let users submit posts & display them on your website.


  1. Michael
    November 25, 2022 Reply

    Great tutorial, thanks a lot.
    Not sure if three plugins are required though... To display the information on the website, GravityView should do the job as well, no?
    So if I have GravityForms and GravityView, the user can submit data via form and this data will automatically be added to the website in a table - or am I missing something here?

    • Carlo
      November 25, 2022 Reply

      Hi Michael, thank you for the comment. Yes, using GravityView is an alternative way to display form entries on the front end. I recommend comparing each approach to see which one suits your needs and situation better. You do not need all three plugins (Document Library Pro, Posts Table Pro, and WooCommerce Product Table) from us to display the form entries on the frontend. You may use only one (or more) depending on what you need to display and the other functionalities you are looking for. If you have follow-up questions, please feel free to reach us through our Support Center. Cheers

  2. Alex
    October 2, 2022 Reply

    I believe the code snippet for linking uploaded file URLs to documents in Document Library Pro is deprecated. When using the code as it is written here it adds multiple instances of the https:// and then the file url within brackets which does not function in use on the document library table.

    • Amir
      October 4, 2022 Reply

      Hi Alex. Thanks for your patience. As a follow up to my colleague's reply, please note that the functions used in the code snippet have not been changed recently and they are still working. Can you please send us the full custom code that you're using via our dedicated Support Center? Cheers.

    • Edge
      October 4, 2022 Reply

      Hi, Alex. Thanks for telling us about this, and I'm very sorry for the inconvenience. I am relaying this to our development team for investigation and will get back to you as soon as we have an update. In the meantime, please let me know if there might be anything else that we may assist you with - or send us a message via our dedicated Support Center.

  3. Paul
    May 23, 2022 Reply

    thanks for the great tutorial. I also have a question related to allowing users to edit posts: is it possible (with editus or something else) to send an email to the post submitter (in my case an employer who submitted a job) with a link that allows them to edit only the specific post they submitted?

    • Edge
      May 23, 2022 Reply

      Hi, Paul. Thanks for your comment and kind words. You could look into using plugins such as Advanced Access Manager or the free User Role Editor to set logged in user and/or user role permissions to edit/write on only the posts they submitted. As for the sending of an email with a link to a page that would allow a logged in user (who has the correct permissions) to edit their posts from the front-end, I suggest you contact support for the plugin that would allow for front-end editing (e.g. Editus or Universal Frontend Editor) for the best advice about going about this, which to me sounds like it would need to be a customization. Cheers.

      • Paul
        May 24, 2022 Reply

        thanks for the quick reply. I'm actually looking to allow non registered users to edit posts they submitted as I'm trying to build something that doesn't require user accounts. The submitter would receive an email with secure link to edit just that post (there are already a number of job boards that function that way but as far as I can tell they're not on wordpress hence why I wonder if it's even possible). I'll contact those plugins' devs directly for more info, thanks again.

        • Edge
          May 24, 2022

          Thanks for your reply and understanding, Paul. I'm glad I could help! The users that you want to allow to submit and then edit posts on your site not being registered nor logged in would of course make such an option trickier to implement. Looking into and enquiring with WordPress auto-login plugins such as Autologin Links might help you further. I hope this helps point you in the right direction. Thanks.

  4. JD
    October 7, 2021 Reply

    Great tutorial - interesting use cases. Just wondering if Gravity Forms can be hosted on one site and if it can create posts on a different site. Ideas?

    • Jae Narra
      October 8, 2021 Reply

      Hi JD, thanks for your comment.

      If you are looking to recreate what we have discussed in this article, then both Gravity Forms and either Posts Table Pro or Document Library Pro needs to be installed/active on the same site.

      However, you can use our plugins separately with Gravity Forms.

      Please let us know if there's anything else we may help you with. You may also reach us via our Support Center. Thank you.

Please share your thoughts...

Your email address will not be published.