Skip to main content
All CollectionsListings
How to create a listing in your marketplace
How to create a listing in your marketplace

This article describe the generic way how your marketplace users can create listings in your marketplace and what are the requirements.

Luis Rodriguez avatar
Written by Luis Rodriguez
Updated over 5 months ago

To create a listing, you first need to create a user account. If you haven't signed up to your marketplace as a new user, you could try the "Log in as user" feature. Once logged into your marketplace, click on the link “Post a new listing” on the top bar. This will take you to the Listing creation form.

Listings are created through the listing creation form, which is composed of multiple sections. Each section needs to be completed before moving to the next, and all sections need to be completed before publishing a listing. The sections in the listing creation form depend on the Listing type and default fields you enabled or disabled. They may include:

  • Listings details

  • Location

  • Pricing & Stock

  • Delivery

  • Availability

  • Photos

  • Payout details (if they have not been added already)

If you don't complete all sections, your listing will stay in draft mode, and you can continue editing it later. Once a listing has been published, you can skip to any section to update it.

You can also create a listing using the “Log in as user” feature if you already have a user account in your marketplace. In your test marketplace, you have full access to user profiles and actions. In a live marketplace, you have limited access to user profiles and actions through this feature: you can’t add and publish a listing on behalf of a user who has not added their payout details themselves.

Adding a listing, in general, follows the same steps.


1. Listing details

Select a Listing type.

If your marketplace has multiple Listing types, you will need to select the Listing type first. The Listing type determines the rest of the form and the requirements for publishing the listing.

Add the rest of the listing details.

By default, each listing will always include the listing title and listing description. Other Listing fields shown in the listing details section of the form depend on the custom Listing fields that you have added, and that correspond to the selected Listing type.

2. Location (for Booking and Free messaging)

You can add a location for your listing. The location needs to be recognized by the Map provider in order to work. You or your users can start typing the location address, the map provider will give options in a dropdown to choose from the recognized addresses.

Once the dropdown options appear, select the first one for the complete address.

The optional field can be used to add details or can be left blank.

3. Pricing & Stock

You can add a price to your listing. The price will be "per unit", depending on the Listing type settings. For daily bookings, the price set will be "per day"; for hourly bookings, it will be "per night", etc.

If you have a "Purchases" listing type, this is the section in the form where you or your providers can add stock to their listings.

4. Delivery (for Purchase)

You can decide how the delivery for this listing is handled. You can choose pick up, delivery, or both. If it is possible to pick up the item, you need to set a pick-up location, which will determine the location of the listing on the map. If it is possible to ship the listing, you can determine the shipping price for the first item and for additional items after that. If both are chosen, the customer will have the chance to select their preferred delivery method when starting a transaction.

5. Availability (for Booking)

When adjusting availability, you first need to choose your time zone and set your default schedule. You can then set availability exceptions that can alter the default availability. You can read more about how availability works here.

6. Add photos

You can add as many photos as you want to the listing. The formats supported are PNG and JPEG.

7. Publish listing (unless it is your first listing)

Once all of the previous sections have been filled out, you should be able to publish the listing unless it is your first listing and you haven't connected your Payout details.


8. Connecting your Bank account with Stripe

A Stripe account is integrated into your test marketplace by default, so you don't need to create one now. However, when you go live or customize your marketplace with code, you will need to create and provide your Stripe account as a marketplace Operator (through Console) before your providers can give their payout information.

When you first create a listing as a user, a pop-up window will open asking you to provide Payout preferences.

Payout preferences pop-up

If you have already added your payment information directly in the Account settings of your profile, you will not see this pop-up.

Click on “Fill in test details”

The system will provide a test bank account for you.

Click "Save details."

Failed to click fill in test details first?

If you click another button first, you will need to fill out the rest of the information by hand. Choose "I'm and individual". Choose "Finland" as your country and add “FI2112345600000785” as the Bank account. Click “Save details”.

You will immediately see another message with the title “Stripe needs more information”. This is normal.

Get verified pop-up

Click “Get verified” to visit Stripe and provide your payment information.

  • Fill out any information that Stripe request

  • Click "Agree & submit"

In the test marketplace, you don’t need to provide your real name, date of birth, or address; however, if asked, you have to provide a valid postal code, and you should provide your real email and phone number since they will be used for verification purposes in the future. This shouldn’t be fundamental for testing purposes, but in the future, if for some reason you want to log back to edit your payout details, you will be asked to verify the phone number or email address.


9. Publish the listing (for good this time)

Once you have provided all the Stripe payout information, you should be able to publish the listing.

You will be redirected to the public listing page and should now be able to find the listing on your search page. You can try searching for your listing.

Did this answer your question?