App ModulesGig Listings
    All App Modules

    Gig Listings

    gigListing

    Learn how to manage your concert schedule with the Gig Listing app, including adding shows, setting up ticket links, and enabling location-based sorting for fans.

    Gig Listing — User Guide

    Welcome to the Gig Listing app! This guide walks you through setting up and managing your concert schedule so fans can discover your upcoming shows.

    Overview

    Gig Listing is a SmartLinks microapp that lets you publish and manage your live concert schedule. Fans see your upcoming and past shows, can filter by location ("Near Me"), and link through to buy tickets. You manage everything from the admin console.

    Getting Started

    First-Time Setup

    1. Open the admin page for your collection. The URL will include your collectionId and appId — these are set automatically by the platform.
    2. You'll see an empty concert list with an "Add New Concert" button.
    3. Click it to add your first gig!

    Tip: If you have many gigs to add at once, ask your AI assistant to bulk-import them from a CSV file (see Import / Bulk Setup below).

    Adding a Concert

    Click "Add New Concert" in the admin console. Fill in the following fields:

    FieldRequiredDescription
    Title✅Name of the gig or event (e.g. "Summer Tour Kickoff")
    Date✅Concert date — pick from the calendar
    Time✅Start time in HH:MM format (e.g. "20:00")
    Venue✅Venue name (e.g. "The Fillmore")
    Location✅City and region (e.g. "San Francisco, CA")
    Ticket URL❌Link where fans can buy tickets
    Sold Out❌Toggle on if the show is sold out
    Description❌Any extra details about the show

    Geocoding (Location on Map)

    When you type a location, the form will attempt to look up the latitude and longitude automatically. This powers the "Near Me" feature on the public page, which lets fans sort gigs by distance.

    • If geocoding doesn't find your location, you can leave it — the gig will still appear, just without distance sorting.
    • For best results, use a format like "City, State" or "City, Country".

    Editing a Concert

    1. Find the concert in your admin list.
    2. Click the pencil icon (Edit).
    3. Update any fields and click Save.

    The concert's updatedAt timestamp is refreshed automatically.

    Deleting a Concert

    1. Find the concert in your admin list.
    2. Click the trash icon (Delete).
    3. The concert is removed immediately.

    Note: Deletion is permanent — there is no undo. Double-check before deleting.

    How Fans See Your Gigs (Public Page)

    The public page shows two sections:

    • Upcoming Shows — Future gigs sorted by date, nearest first.
    • Past Shows — Previous gigs shown below (collapsed by default).

    "Near Me" Feature

    If a fan allows location access in their browser, gigs are sorted by distance with a distance badge (e.g. "12 km away"). Fans who decline location access see gigs sorted by date only.

    Ticket Links

    If you've added a ticket URL, fans see a "Get Tickets" button. Sold-out shows display a "Sold Out" badge instead.

    Import / Bulk Setup

    If you have many concerts to add, you can ask your AI assistant to import them from a CSV file. Here's the template:

    title,date,time,venue,location,latitude,longitude,ticketUrl,soldOut,description
Summer Tour Kickoff,2026-06-15,20:00,The Fillmore,San Francisco CA,37.784,-122.433,https://tickets.example.com/1,false,Opening night
Rock the Park,2026-07-04,19:00,Central Park,New York NY,40.785,-73.968,,false,Free outdoor festival

    Field Rules

    • date must be YYYY-MM-DD format
    • time must be HH:MM format (24-hour)
    • soldOut should be true or false
    • latitude/longitude are optional but enable the "Near Me" feature
    • ticketUrl is optional — leave blank if no ticket link

    Your AI assistant will validate each row and report how many were imported successfully.

    Widgets

    The UpcomingGigsWidget can be embedded on other pages in the platform to show a preview of your next few gigs.

    SizeWhat It Shows
    CompactNext 2 gigs — date and venue only
    StandardNext 3 gigs — date, venue, location, and ticket link
    LargeNext 3 gigs — full detail with descriptions

    The widget links back to your full gig listing page via the "View All Gigs" button.

    FAQ / Troubleshooting

    Q: I added a concert but it doesn't show on the public page. A: Check that the concert date is in the future. Past concerts appear in the "Past Shows" section, which may be collapsed.

    Q: The "Near Me" feature isn't working for fans. A: Fans need to grant location permission in their browser. If they decline, gigs are sorted by date instead. Also ensure your concerts have latitude/longitude set.

    Q: I don't see the admin controls. A: Make sure you're accessing the admin page (not the public page) and that your account has admin permissions for this collection.

    Q: Can I reorder concerts manually? A: Concerts are always sorted by date automatically — nearest upcoming first. You can't manually reorder them.

    Q: How do I mark a show as sold out after it was listed? A: Edit the concert and toggle the Sold Out switch on. The public page will show a "Sold Out" badge instead of the ticket link.

    Q: What happens to past concerts? A: They remain in your data and show in the "Past Shows" section. You can delete them from the admin if you want to clean up.