Custom Fields Guide

Welcome to tablrr! This guide explains how to create and use custom fields to capture additional information about your operators beyond the standard fields. Custom fields allow you to add specialized data that's unique to your needs.

Table of Contents

1. Getting Started
2. Creating Custom Fields
3. Adding Values to Operators
4. Using Custom Fields in Listings
5. Column Overrides with Custom Fields
6. Managing Custom Fields
7. Troubleshooting

Getting Started

Custom fields let you collect and display additional information about your operators that isn't included in the standard fields. For example, you might want to track minimum deposits, maximum bets, welcome bonuses, or any other operator-specific details.

What you can do with custom fields:

• Create custom field definitions that appear on all operator forms
• Add different types of fields: text, numbers, URLs, or dropdown selections
• Organize and reorder custom fields to match your workflow
• Use custom fields in your listings
• Override column displays to show custom field values instead of standard fields

Note: Custom fields are available on paid plans (Hobby tier or higher). Free tier users can use the standard operator fields.

Creating Custom Fields

Before you can add custom field values to operators, you need to create field definitions. These definitions determine what type of information you'll collect and how it's displayed.

Accessing Custom Fields

1. Navigate to Settings from your dashboard
2. Click on "Custom Fields" in the settings menu
3. You'll see a list of your existing custom fields (if any)

Note: You can also navigate to Custom Fields from Operators main page by clicking on "Custom Fields" button on the top-right corner.

Creating a New Field

1. Click the "Create Custom Field" button
2. Fill in the field information:
   • Field Name: The label that will appear on operator forms (e.g., "Minimum Deposit" or "Welcome Bonus")
   • Field Type: Choose from:
     • Text: For any text information
     • Number: For numeric values
     • URL: For web links
     • Select: For dropdown options (you'll define the options)
   • Options: If you chose "Select" type, add the available options (press Enter after each option)
   • Required: Check this box if the field must always have a value
3. Click "Save" to create the field

Field Types Explained

• Text: Use for any written information like descriptions, notes, or general details
• Number: Use for numeric values like amounts, limits, or counts
• URL: Use for web links that should be clickable
• Select: Use when you want to limit values to specific options (e.g., "Yes/No", "Low/Medium/High", or a list of specific values)

Adding Values to Operators

Once you've created custom field definitions, they automatically appear on all create operator and edit operator forms.

Adding Custom Field Values

1. Go to the Operators section
2. Create a new operator or edit an existing one
3. Scroll down to the "Custom Fields" section
4. You'll see all your custom fields listed
5. Fill in the values for each field
6. Click "Save" to store the values

Note: Custom field values are stored with each operator. Different operators can have different values for the same custom field.

Editing Custom Field Values

1. Edit the operator as you normally would
2. Find the custom fields section
3. Update any values you want to change
4. Save the operator

Important: When you update custom field values, those changes automatically sync to all listings that include that operator, just like standard operator fields.

Using Custom Fields in Listings

Custom fields are used in listings through column overrides. This allows you to display custom field values in existing columns by overriding which field is shown.

Column Overrides with Custom Fields

One powerful feature of custom fields is the ability to override which field is displayed in a column. This lets you show custom field values in columns that normally show standard fields.

Understanding Column Overrides

Column overrides allow you to change what information appears in a specific column. For example, you could make the "Bonus" column show a custom "Welcome Bonus" field instead of the standard bonus field.

Setting Up a Column Override

1. Edit your listing
2. In the column configuration section, find the column you want to override
3. Click on the dropdown with the column name
4. You'll see two groups:
   • Custom Fields: Your custom fields
   • Core Fields: Standard operator fields (name, rating, bonus, etc.)
5. Select the field you want to display in that column
6. An arrow icon (↔) appears next to overridden columns
7. Save your listing

Example: If you have a "Welcome Bonus" custom field and want it to appear in the "Bonus" column:

1. Find the "Bonus" column in your listing configuration
2. Click the dropdown
3. Select "Welcome Bonus" from the Custom Fields group
4. The Bonus column will now show your custom Welcome Bonus values instead

Resetting Column Overrides

To restore a column to its original field:

1. Click the dropdown for the overridden column
2. Select the original field name (it will show "(Default)" next to it)
3. The column will revert to showing its original field

Tip: Not all columns can be overridden. Some columns like logos or complex composite columns are protected to prevent display issues.

Type Compatibility

The system automatically filters which fields can be used in each column based on data type compatibility:

• Text columns can show: text, numbers, select field values, etc.
• Array columns (like Features) can only show other array-type fields
• Some columns are designed for specific data types and will only show compatible fields

If you don't see a field in the dropdown, it means that field type isn't compatible with that column.

Managing Custom Fields

As you create more custom fields, you'll want to organize and manage them effectively.

Viewing Your Custom Fields

The custom fields settings page shows:

• Field name
• Field type
• Whether it's required
• Actions: Edit and Delete buttons

Fields are displayed in the order they'll appear on operator forms.

Reordering Custom Fields

1. Go to Settings > Custom Fields
2. Drag fields up or down to reorder them
3. The order you set here is the order they'll appear on operator forms
4. Changes save automatically

Tip: Put your most commonly used fields at the top for easier access when editing operators.

Editing Custom Fields

1. Find the custom field you want to edit
2. Click the "Edit" button (pencil icon)
3. Update the field name, type, or options
4. Click "Save" to update

Important: Changing a field type may affect existing values. For example, changing a "Text" field to "Number" might cause issues if operators have non-numeric values. Be careful when changing field types.

Deleting Custom Fields

1. Find the custom field you want to delete
2. Click the "Delete" button (trash icon)
3. A warning will show how many operators have values for this field
4. Confirm the deletion

Warning: Deleting a custom field will:

• Remove the field from all operator forms
• Remove all values from operators (this data cannot be recovered)
• Remove the field from any listings where it's displayed
• Remove any column overrides that use this field

Note: If a custom field is used in a column override, deleting it will cause that column to revert to its default field automatically.

Troubleshooting

I can't see the Custom Fields option

Issue: Custom Fields doesn't appear in Settings

Solution:

• Custom fields are only available on paid plans (Hobby tier or higher)
• Free tier users can use standard operator fields only
• Upgrade your plan to access custom fields
• Check your current plan in the billing section

My custom field isn't appearing on operator forms

Issue: Created a custom field but it doesn't show when creating/editing operators

Solution:

• Ensure you've saved the custom field definition
• Refresh the operator form page
• Verify the field wasn't deleted

I can't select a custom field in column overrides

Issue: Custom field doesn't appear in the dropdown when setting up column overrides

Solution:

• Ensure the custom field type is compatible with the column type
• Text columns can show text, number, URL, or select fields
• Array columns can only show array-type fields
• Some columns (like logos) cannot be overridden

I deleted a custom field by mistake

Issue: Accidentally deleted a custom field

Solution:

• Unfortunately, deleted custom fields and their values cannot be recovered
• You'll need to recreate the field definition
• All operator values for that field have been removed
• Any listings using that field will need to be updated
• Consider being more careful with deletions, or create a backup of important data

Custom field values aren't updating in my listings

Issue: Changed custom field values but listings still show old values

Solution:

• Ensure you saved the operator after updating custom field values
• Wait a moment for changes to sync
• Refresh the listing preview or page
• Check that you're editing the correct operator
• Verify the listing is actually using that custom field (check column configuration)

I want to change a custom field type

Issue: Need to change from one field type to another

Solution:

1. Edit the custom field definition
2. Change the field type
3. Save the changes
4. Be aware that existing operator values won't be automatically updated:
   • If you change "Text" to "Number", operators with non-numeric values will cause validation errors when you try to edit them
   • If you change "Select" to "Text", existing values remain but you lose the dropdown constraint
   • You'll need to manually update all operators with incompatible values before you can edit them again

Tip: It's often safer to create a new field with the desired type and migrate values manually, then delete the old field.

Column override isn't working

Issue: Set up a column override but it's not showing the expected values

Solution:

• Ensure the source field (the replace "with" field) has values set on operators
• Check that operators in the listing actually have values for that custom field
• Verify the override was saved (look for the arrow icon next to the column)
• Try removing and re-adding the override
• Check that the field type is compatible with the column type

Next Steps

Now that you understand custom fields:

1. Create your first custom field to track additional operator information
2. Add custom field values to your operators
3. Use custom fields in your listings to display specialized information
4. Experiment with column overrides to customize how information is displayed
5. Organize your custom fields by reordering them for easier access
6. Keep custom field values up to date so your listings stay current

Custom fields give you the flexibility to track and display exactly the information that matters most to your business. Use them to create more detailed and useful comparison tables for your audience.

Thank you for using tablrr!