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. Geo Targeting
5. Choosing Layouts and Styles
6. Custom Templates
7. Configuring Columns
8. Live Preview
9. Editing Listings
10. Managing Listings
11. 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. Optionally assign tags in the Basic Information section. Select existing listing tags or type a new name to create one. Manage all listing tags under Settings > Tags.
5. Choose a layout type:
   • Table: Traditional row-based layout
   • Grid: Card-based grid layout
   • Custom: A bespoke layout built to your brand (Business plan)
6. Select a style for your chosen type
7. Select which operators to include in this listing
8. Configure which columns to display
9. Use the live preview to see how your listing will look
10. 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.

Geo Targeting

Geo targeting lets a single listing show different operators to visitors based on their country - for example, displaying UK-specific operators only to UK visitors while showing a universal set to everyone else. No duplicate listings needed.

Geo targeting is a Growth plan feature (and above).

To enable it, open any listing editor and turn on the Geo Targeting toggle in the operator selection section. Once enabled:

• Each operator row gets a country control. The default is Everywhere (no restriction). Click it to assign one or more countries.
• A country selector appears above the live preview so you can see exactly what each audience will see.

For full setup and WordPress plugin delivery details, see the Geo Targeting guide.

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: #0 (free), #1, #2 (premium)

• Grid: Card-based layout with operator cards

  • Best for: Visual browsing, mobile-friendly displays
  • Styles available: #0 (free), #1, #2 (premium)

• Custom: A fully bespoke layout built to your exact specifications

  • Available on the Business plan
  • See Custom Templates for details

Selecting a Style

1. After choosing a layout type, the available styles appear below
2. Free styles are available to all users
3. Premium styles require a Hobby plan or higher
4. Custom styles are exclusive to your account and require a Business plan
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.

Custom Templates

Custom templates are bespoke listing layouts built by tablrr to match your brand - your colors, typography, and design language. They appear as a Custom option in the layout type selector.

Custom templates are available on the Business plan.

How to Request a Custom Template

1. Make sure you're on the Business plan (see Billing)
2. Email support@tablrr.app with the subject line "Custom template request"
3. Include the following in your email:
   • Your tablrr account email
   • Existing designs/mockups
   • Any additional comments
4. I will follow up to confirm requirements and timeline
5. Once built, the template is assigned to your account and appears in the Custom type selector

Note: Custom templates are built specifically for your account and are not shared with other users.

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)
   • Custom Fields (if you have any set up)
2. Toggle columns on or off to show or hide them
3. Customize column labels if desired
4. Use column overrides to change which field is displayed in a column (available for paid plans)
5. 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.

Tip: With column overrides, you can make any column display a different operator field. For example, you could make the "Bonus" column show a custom "Welcome Bonus" field instead. Learn more about custom fields and column overrides.

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 tags
   • 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
• Public ID
• Tags (first tag name; if there are more, a "+ N" count)
• 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

Filtering by Tag

1. Use the Tags filter dropdown (shown when you have at least one listing tag)
2. Select "All Tags" to see every listing, or choose a specific tag
3. The list updates to show only listings that have that tag

Managing listing tags: Go to Settings > Tags to create, edit, or delete listing tags. Use the filter to show only Listing tags. Each tag row shows how many listings use it. You can also create a new tag when assigning tags on the listing form by typing a name in the tags field.

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!