# Listings

{% hint style="info" %}
**Tip:** Read the [Quick start](#quick-start) guide to get your first listing up and running quickly.
{% endhint %}

### About

This Add-on allows you to display contact entries on your front-end in a table like fashion (list). Hence the name "Listings". A quick preview of how a listing might look on your Front-end:

<figure><img src="/files/Ymr6qfuxtl5DHzlX8SOt" alt="A table/list on the WordPress front-end displaying contact entries (form submissions)."><figcaption><p>A table/list on the WordPress front-end displaying contact entries (form submissions).</p></figcaption></figure>

{% hint style="info" %}
You can try this Add-on for 15 days for free by going to **Super Forms > Add-ons** in your WordPress dashboard.
{% endhint %}

### Quick start

The Add-on comes with a 15 day free trial, so you can try it out for free. To enable the trial, login to your WordPress site and navigate to **Super Forms > Licenses**. On this page you can start the 15 day trial for the **Listings** Add-on. Once the trial is activated, you can navigate to any of your existing forms via **Super Forms > Your forms**, or create a new form **Super Forms > Create form**.

Now click on the **\[Listings]** TAB at the top of the builder page:

<div align="left"><figure><img src="/files/z568Bxua9vMSNoywGgRu" alt="Creating and configuring a listing for your WordPress form."><figcaption><p>Creating and configuring a listing for your WordPress form.</p></figcaption></figure></div>

Here you will find all the settings and options for the Add-on. To create your first listing, you can check the option **Enable listings for this form**. To edit your listings settings you can click the cogwheell icon as shown below:

<div align="left"><figure><img src="/files/71g3brfMcwAGLdRiWPvA" alt="Edit an existing listing from the back-end."><figcaption><p>Edit an existing listing from the back-end.</p></figcaption></figure></div>

{% hint style="info" %}
**Tip:** you most likely will want to setup a page with a Fullwidth layout (if your theme supports it), this way the most columns can be visible at once (in case you have many columns defined to be displayed)
{% endhint %}

Depending on your settings your listing should be visible (or not) and might look something like this:

<figure><img src="/files/Ymr6qfuxtl5DHzlX8SOt" alt="Example of how the list/table might look on your WordPress site."><figcaption><p>Example of how the list/table might look on your WordPress site.</p></figcaption></figure>

### Settings

There are many settings that give you control over what and how the listing will be displayed to the end-user, such as:

* Control to who the listing will be displayed and display an optional message to other users that can't view it;
* Control from which forms entries should be retrieved, e.g. "Current form", "All forms", or "Specific form ID's";
* Only retrieve entries between a specific date range (from/till), you can leave from or till blank to have no limit on either side;
* Control who can see which entries
* Optionally display a message to the user if no entries are found
* Allow/Disallow administrators or other roles/ID's to **view** any entries
* Allow/Disallow users to **view** their own entries
* Allow/Disallow administrators or other roles/ID's to **edit** any entries
* Allow/Disallow users to **edit** their own entries
* Allow/Disallow administrators or other roles/ID's to **delete** any entries
* Allow/Disallow users to **delete** their own entries
* Show custom columns that will be mapped to your form fields and whether or not they can filter/sort this column
* Show predefined columns and whether or not they can filter/sort this column
  * Entry title;
  * Entry status;
  * Entry date;
  * WC order *(Add-on required)*;
  * WC order status *(Add-on required)*;
  * PayPal order *(Add-on required)*;
  * PayPal order status *(Add-on required)*;
  * PayPal subscription *(Add-on required)*;
  * Created post title *(Add-on required)*;
  * Created post status *(Add-on required)*;
  * Generated PDF *(Add-on required)*;
  * Author username *(if user was logged in during form submission)*;
  * Author first name *(if user was logged in during form submission)*;
  * Author last name *(if user was logged in during form submission)*;
  * Author full name *(if user was logged in during form submission)*;
  * Author nickname *(if user was logged in during form submission)*;
  * Author display name *(if user was logged in during form submission)*;
  * Author E-mail *(if user was logged in during form submission)*;
  * Author ID *(if user was logged in during form submission)*;
* For each column you can define if the value should have a link to one of the following options
  * None (no link);
  * Edit the contact entry (backend);
  * WooCommerce order (backend);
  * WooCommerce order (front-end);
  * PayPal order (backend);
  * PayPal subscription (backend);
  * Generated PDF file;
  * Created post/page (backend);
  * Created post/page (front-end);
  * The author page (front-end);
  * The author profile (backend);
  * Author E-mail address (mailto:);
  * E-mail address (mailto:);
  * Custom URL;

### Pricing

<table><thead><tr><th width="152">Volume</th><th width="189">Price per license</th><th>Total</th></tr></thead><tbody><tr><td>1+</td><td>$5</td><td>1 license would cost $5 p/m</td></tr><tr><td>5+</td><td>$3</td><td>5 licenses would cost $15 p/m</td></tr><tr><td>10+</td><td>$2.5</td><td>10 licenses would cost $25 p/m</td></tr><tr><td>20+</td><td>$2</td><td>20 licenses would cost $40 p/m</td></tr><tr><td>40+</td><td>$1.5</td><td>40 licenses would cost $60 p/m</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.super-forms.com/features/integrations/listings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.