How to create a new listing type for services on Tangram

Published on
January 23, 2025
Paris Mielke

Summary:

This video explains how to create and configure listing types on the Tangram platform, which represent different kinds of user-created listings, such as physical products, digital products, services, rentals, or events. The walkthrough focuses on setting up a "one-on-one service" listing type, detailing the required steps and best practices.

Key Steps:

  1. Creating a Listing Type:
    • Click "New" to create a listing type, name it (e.g., "Service"), and assign roles (e.g., sellers/service providers).
  2. General Tab:
    • Add a name and description.
  3. Scheduling Tab:
    • Enable availability tracking at the user level for services requiring customer scheduling.
  4. Monetization Tab:
    • Set fees (e.g., percentage or flat rate for platform commissions) and choose whether payments go through Stripe Connect or directly to the platform account.
  5. Permissions Tab:
    • Enable settings like confirmation flows, login requirements, guest checkouts, and advanced payment options (e.g., add-ons or custom checkout questions).
  6. Actions Tab:
    • Configure post-transaction actions (e.g., chat, reviews) by adding buttons to the transaction receipt or details page.
  7. Terminology and Field Groups:
    • Define buyer/seller terms and required fields for the listing creation form. Manually connect fields (e.g., title) to the listing type to ensure they appear in the form.
  8. Field Setup:
    • Add fields (e.g., required title) to the listing creation form by connecting them to the appropriate listing type.

Note: After creating a listing type, no fields are attached by default. You'll need to manually add and configure fields to the listing creation form and determine their visibility and requirements.




Video Transcription:

" In this video I'll be covering how to create new listing types on your platform where listing types are different types of listings that users can create across your platform. That could be physical products, digital products, rentals, events, classes, one on one services, group classes, group services, jobs, and I will go one by one through each of those to show you how I would set up a new version of it right now.

If we were to create a one on one service, We would click plus new name the listing type something like service or one on one service and define what role can create that listing type.  Usually it's the service providers or sellers. I already have one created for services, so I'll click in to edit that and talk through each of the tabs and what settings you'll probably want to enable.

On the general tab just the name and description is, is necessary to start with. The scheduling tab, if it's a service where you want the customer to select from the availability of the user, the availability should be tracked at the user or seller level, so you'll select user here, and you want to check the appointment radio button box here.

And that will allow the customer when they're checking out to select from the schedule or availability of the seller. On the monetization tab, here you'll just determine what percentage you want to collect off every transaction using the four fields at the bottom here.  If we wanted to say, take 5 percent from the sellers on every transaction.

If we're making 100, we would take 5 from And we could also upcharge the customer 5%, so maybe the customer pays 105 on a 100 listing if we do this. You can mix and match with flat fees, so if we added 2 here, it would charge the vendor 5 percent plus 2 on every or 2 of whatever your currency unit is on your platform on every transaction.

Or we can just make it free by keeping everything at zero. There's one more important setting that you may want to add here is if you want to direct all of the payments to your business Stripe account and you don't want to automatically pay out sellers through Stripe Connect, if and have sellers connect their bank account for automatic payouts, you would check this box.

You would say direct all payments to the platform Stripe account. And that just means you'll have to manually pay out each of your users, but all of the money will go through you first. The permissions tab for services, you'd probably want to have a confirmation flow, you'd check this box such that the sellers have to confirm the service before it's officially booked.

It's best practice to check this box to force users to log in to book services if you have chat enabled. Otherwise, leave this unchecked if you want guest checkout. It's just if you have chat enabled there can be some inconsistencies with UX unless you have this checked.  It's best practice if you do have chat or want to have chat enabled to check this box to force users to log in to book services.

And it's also beneficial to collect. Users information when they sign up anyway, if you want to retarget them later.  It's best practice to keep this checked, but if you do absolutely want to prioritize guest checkout, uncheck it. If you want the ability to have add ons or upsells, For services, I would check the Enable Advanced Payment Builder, which will enable Enlisting Creation the ability to create add ons.

If you check this box here, it allows sellers to ask questions of the customer on checkout that are unique to the service, but it's not essential usually, so you can leave that unchecked in most cases. If you want to require admins to approve all transactions before they are visible to the seller, you can check this box.

That's pretty rare, but just wanted to point that out as well. Under the actions tab, it automatically adds the chat buttons on the receipt page. This is what button should show up on the receipt page, basically, after a customer makes a transaction.  Everyone has the ability to chat with one another by default.

You can click the trash icon if you don't want chat enabled between providers and customers here. Or you can add new action buttons, like the ability to leave a review, which should would be this route slash review for the TX instance, the transaction instance. And you can make that visible to customers after the service is confirmed and create the action button.

And that would putting it exactly as we see here would add a review button on the transaction details page. And by transaction details page, I mean on the transactions table, if you go to the details tab here, which is something you're also redirected to by default after making a transaction, You can edit what buttons show up in the bottom through that actions button panel we were just on.

For services, I think we left off on the actions button. For add ons, you can create platform level add ons here. I won't go too deep in that. We'll probably have an advanced video for if you have add ons enabled on your platform. Terminology, best practice to just put the buyer and seller terminology here and the call to action terminology you want.

Like, if it's a service, it would probably be book now. The buyer might be the client. The seller might be the service provider or provider, but you can name them whatever makes the most sense for in context of services on your platform. And field groups usually isn't necessary either. It's more of an advanced feature we'll cover in a later video.

That is how to create a listing type service in the back end of Tangram. Please keep in mind, after you create any new listing type, there won't be any fields attached to it.  If I Went in as a seller and tried to create a service, there would be no fields in the listing creation form. You also have to go through the steps of going to the fields table and manually connecting what fields you want on that form.

If we wanted the title of the listing or the service to be in that listing creation form, we'd search for. Or create a new field if it doesn't exist, go to the edit tab and connect that field group to services. It looks like it's already connected in this case, but if you create a new listing type, it won't, there will be no fields connected to it at first.

You'll have to manually click plus new and decide what listing type you want to connect to the field. And usually, if you want it to show up on the And always, if you want the field to show up on the listing creation form, you would select this field should be shown when users create listings of this type.

And you can decide by checking this box whether it's required or not required when you're creating the listing. The other options on here when you're connecting fields to field groups is do you want this to be a question on the checkout page, in which case you would select, I want users to fill this out when they book listings of this type.

And the last one's very rare, it's If you want the field that you created to be visible to sellers on the receipt, basically, on the confirmation page for users who create listings of this type, the only case you'd probably want that is if there's, like, a post, service, docs, or review materials that you want the seller to be able to share with the customer by pasting it into the, the transaction after the service happened.

In most cases, when you're creating fields and looking to connect it to a listing creation form, it'll be, you'll just click the connected field groups, you'll click plus new, select the one on one service, whatever listing type you want the field connected to the form, and say when users create listings of this type, make them fill out the title field on the one on one service listing creation form, and it should be a required field.

And you'd click create connection, it would add it to that dropdown, but it's already done there."

Get notified of new features & resources.

Subscribe to our newsletter and stay up-to-date on our roadmap, new features, and free resources to help you scale your marketplace.

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
templatetemplatetemplatetemplate
templatetemplatetemplatetemplate
templatetemplatetemplatetemplate
templatetemplatetemplatetemplate
object