Listings Guide

Welcome to tablrr! This guide explains how to create and manage listings (comparison tables) that automatically populate with operator data and can be embedded on your websites.

Table of Contents

1. Getting Started
2. Creating Listings
3. Selecting Operators
4. Configuring Columns
5. Choosing Layouts and Styles
6. Live Preview
7. Editing Listings
8. Managing Listings
9. Troubleshooting

Getting Started

Listings are comparison tables or grids that display your operators in an organized, styled format. The key advantage of tablrr is that when you update operator information, all listings that include those operators automatically reflect the changes.

What you can do with listings:

• Create multiple comparison tables from your operator database
• Choose from different layout types (table or grid) and styles
• Select which operators appear in each listing
• Customize which columns to display and how they're labeled
• See a live preview while building
• Embed listings on your websites via API

Creating Listings

To create a new listing:

1. Navigate to the Listings section from your dashboard
2. Click the "Create Listing" button
3. Give your listing a name (e.g., "Top 10 Casinos" or "Best UK Sportsbooks")
4. Choose a layout type:
   • Table: Traditional row-based comparison table
   • Grid: Card-based grid layout
5. Select a style for your chosen type
6. Select which operators to include in this listing
7. Configure which columns to display
8. Use the live preview to see how your listing will look
9. Click "Save" to create the listing

Note: You can always edit the listing after creation to change operators, columns, or styling.

Selecting Operators

When creating or editing a listing, you'll select which operators to include:

1. In the operator selection section, you'll see all operators from your database
2. Use the search box to find specific operators by name
3. Click on operators to add them to your listing
4. Selected operators appear in a list below
5. Drag operators up or down to reorder them
6. Click the remove button (X) to remove an operator from the selection

Tip: The order you set operators in the builder is the order they'll appear in your listing. You can reorder them at any time by editing the listing.

Configuring Columns

You can control which operator information appears in your listing:

1. In the column configuration section, you'll see available columns:
   • Logo
   • Name
   • Rating
   • Description
   • Features
   • Affiliate Link (CTA button)
2. Toggle columns on or off to show or hide them
3. Customize column labels if desired
4. The live preview updates automatically as you change column settings

Note: Some layouts may have different column options or display formats. The available columns depend on the layout type and style you've selected.

Choosing Layouts and Styles

tablrr offers different layout types and styles to match your website's design:

Layout Types

• Table: Traditional comparison table with rows and columns

  • Best for: Side-by-side comparisons, detailed information
  • Styles available: Minimal, Modern

• Grid: Card-based layout with operator cards

  • Best for: Visual browsing, mobile-friendly displays
  • Styles available: Card, Compact

Selecting a Style

1. After choosing a layout type, select a style
2. Each style has a preview image showing how it looks
3. Free styles are available to all users
4. Premium styles require a paid plan (Hobby tier or higher)
5. The live preview shows exactly how your listing will appear

Note: You can change the layout type and style after creating a listing, but this may affect how your data is displayed.

Live Preview

The listing builder includes a live preview that shows exactly how your listing will appear:

1. The preview updates automatically as you make changes
2. You'll see your selected operators displayed in the chosen layout and style
3. Column configuration changes are reflected immediately
4. Use the preview to fine-tune your listing before saving

Tip: The preview shows a real-time representation of your listing. What you see in the preview is what will appear when embedded on your website.

Editing Listings

To update an existing listing:

1. Go to the Listings section
2. Find the listing you want to edit
3. Click the "Edit" button (pencil icon) next to the listing
4. Make any changes you want:
   • Change the listing name
   • Add or remove operators
   • Reorder operators
   • Change column configuration
   • Switch layout type or style
5. Use the live preview to see your changes
6. Click "Save" to update the listing

Important: When you update a listing, the changes automatically sync to all websites where the listing is embedded. You don't need to update each website individually.

Managing Listings

As you create more listings, you'll want to organize and find them easily.

Viewing Your Listings

The listings page shows:

• Listing name
• Layout type (table or grid)
• Style name
• Number of operators included
• Creation date
• Actions: Edit and Delete buttons

Listings are displayed in a paginated list, showing 15 listings per page.

Searching Listings

1. Use the search box at the top of the listings list
2. Type any part of the listing name
3. Results filter automatically as you type
4. Press Escape to clear the search

Filtering by Type

1. Use the type filter dropdown
2. Select "All Types" to see everything, or choose:
   • Table
   • Grid
3. The list updates to show only listings of the selected type

Deleting Listings

To remove a listing:

1. Find the listing you want to delete
2. Click the "Delete" button (trash icon)
3. Confirm the deletion
4. The listing will be removed and will no longer be available for embedding

Warning: Deleting a listing removes it from all websites where it's embedded. This action cannot be undone.

Troubleshooting

I can't create a new listing

Issue: "You've reached your listing limit"

Solution:

• Free tier users have a limit on the number of listings they can create
• Delete unused listings to free up space, or
• Upgrade to a paid plan for unlimited listings
• Check your current usage in the billing section

Issue: "No operators available"

Solution:

• You need to create at least one operator before creating a listing
• Go to the Operators section and create an operator first
• Then return to create your listing

My listing preview isn't showing

Issue: Preview not loading or showing errors

Solution:

• Ensure you've selected at least one operator
• Check that you've chosen both a layout type and style
• Wait a moment for the preview to load
• Try refreshing the page if the preview seems stuck
• Check your browser console for any error messages

I can't select a premium style

Issue: Premium styles are grayed out or unavailable

Solution:

• Premium styles require a paid plan (Hobby tier or higher)
• Upgrade your plan to access premium styles
• Free styles are available to all users
• Check your current plan in the billing section

Operators aren't appearing in my listing

Issue: Selected operators not showing in preview or final listing

Solution:

• Ensure you've actually selected operators (they should appear in the selected list)
• Check that operators have the required data (some columns may be empty if operator data is missing)
• Try removing and re-adding operators
• Verify that operators haven't been deleted from your database

I want to change the order of operators

Solution:

1. Edit the listing
2. In the operator selection section, find the selected operators list
3. Drag operators up or down to reorder them
4. The order in the list is the order they'll appear in your listing
5. Save the changes

My listing looks different on my website

Issue: Listing appearance differs from preview

Solution:

• Check that your website is using the latest listing code
• Clear your website's cache if it uses caching
• Verify that the listing hasn't been updated since you embedded it
• Some website themes may override certain styles - check your theme's CSS

Next Steps

Now that you understand how to create listings:

1. Create your first listing to see how it works
2. Experiment with different layout types and styles
3. Learn how to verify and manage websites to embed your listings
4. Keep your operator data up to date so listings stay current
5. Create multiple listings for different pages or purposes

Thank you for using tablrr!