Market Categories

At a Glance

What This Section Does

Manage market categories that organize and classify prediction markets across the platform. Create, edit, and control categories that help users discover markets based on thematic classifications.

Who Should Use This

1. Platform Administrators: Manage the category taxonomy
2. Market Operations Team: Organize market classifications
3. Content Managers: Maintain category structure and naming

Most Common Tasks

1. Add New Category: Create new classification categories
2. Edit Category: Update category names and icons
3. View Categories: Browse all active and deleted categories
4. Delete Category: Remove categories from active use

Before You Start

Make sure you have these permissions:

1. market_categories: Required for managing market categories
2. Access to Markets > Categories: Required to view and manage categories

Overview

Section	Description
Overview	Central hub for creating, editing, and managing market categories that organize prediction markets across the platform.
Main Features	Category List View, Add Category, Edit Category, Delete Category, Search and Filter

View & Search Features

Feature	Permission Required	Whitelist Required
Viewing Categories	market_categories	None
Searching Categories	market_categories	None
Filtering by Status	market_categories	None

Create & Manage Features

Feature	Permission Required	Whitelist Required
Creating Categories	market_categories	None
Editing Categories	market_categories	None
Deleting Categories	market_categories	None
Bulk Deletion	market_categories	None

1. Market Categories Management

Overview

Menu Purpose: Create and manage category classifications that organize markets thematically across the platform.

Key Features:

1. Category Creation Function
2. Category Editing Function
3. Category Deletion Function
4. Status Management (Active/Deleted)
5. Search and Filter Capabilities
6. Bulk Operations

2. Category List Structure

Table Columns

The Categories page displays a table with the following structure:

Column	Description
Select	Checkbox for selecting categories for bulk operations
Icon	Visual icon representing the category (displayed as icon name)
Name	Category name (e.g., E-Sports, Tech, Crypto)
Status	Current status: Active or Deleted
Created At	Date and time when the category was created (format: DD/MM/YYYY HH:MM)
Actions	Quick action menu with Edit and Delete options

Column Visibility

You can customize which columns are visible using the View button:

• Icon
• Name
• Status (labeled as "isDeleted")
• Created At

All columns are visible by default. Toggle visibility to customize your view.

3. Adding a New Category

Purpose

Create new category classifications to organize markets thematically and improve discoverability.

When to Use

Use when you need to add a new market category classification to the platform taxonomy.

Steps

Step	Action	Details
1	Access Categories Page	Navigate to Markets > Categories from the main navigation.
2	Click Add Category Button	Click the Add Category button in the top right corner of the page.
3	Enter Category Name	In the Name field, enter a clear, descriptive category name (required).
4	Enter Icon Name	In the Icon field, enter a valid Lucide icon name (e.g., flag, trophy, chart).
5	Review Icon Options	Click the here link to view the full list of available icons at lucide.dev/icons.
6	Submit Category	Click the Submit button to create the category.

Outcome

After successful submission, the new category appears in the table with "Active" status and becomes available for use when creating or editing markets.

Key Notes

1. Both Name and Icon fields are required before the Submit button becomes active.
2. Icon names must match valid Lucide icons exactly.
3. Categories appear in alphabetical order by creation date (most recent first) by default.
4. New categories are automatically set to "Active" status.

4. Editing a Category

Purpose

Modify category names or icons to maintain accurate classification and branding.

When to Use

Use when you need to update category names, change icons, or correct category information.

Steps

Step	Action	Details
1	Access Category	Locate the category you want to edit in the table.
2	Open Actions Menu	Click the Edit item button (three dots icon) in the Actions column.
3	Select Edit Option	Click Edit from the dropdown menu.
4	Modify Category Name	Update the Name field as needed.
5	Change Icon	Update the Icon field with a new Lucide icon name if needed.
6	Submit Changes	Click the Submit button to save your changes.

Outcome

The category is updated immediately with the new information and reflects changes across all associated markets.

Key Notes

1. Changes to category names automatically update all markets using that category.
2. Icon changes apply retroactively to all existing markets with that category.
3. The edit dialog shows current values pre-filled for reference.
4. Both fields remain required even when editing.

5. Deleting a Category

Purpose

Remove categories from active use while preserving historical data and associations.

When to Use

Use when a category is no longer needed, outdated, or being consolidated with another category.

Steps to Delete Individual Category

Step	Action	Details
1	Access Category	Locate the category you want to delete in the table.
2	Open Actions Menu	Click the Edit item button (three dots icon) in the Actions column.
3	Select Delete Option	Click Delete from the dropdown menu.
4	Confirm Deletion	Confirm the deletion action when prompted.
5	Verify Status Change	The category status changes to "Deleted" in the table.

Steps for Bulk Deletion

Step	Action	Details
1	Select Categories	Check the boxes next to the categories you want to delete.
2	Review Selection	Verify the correct categories are selected. The count displays in the Delete X button.
3	Click Delete Button	Click the Delete X button that appears (where X is the number selected).
4	Confirm Bulk Deletion	Confirm the bulk deletion action when prompted.
5	Verify Status Changes	All selected categories change to "Deleted" status.

Alternative: Select All

Step	Action	Details
1	Select All Categories	Check the Select all checkbox in the table header.
2	Review Total Count	The Delete X button shows the total number of categories.
3	Proceed with Deletion	Follow steps 3-5 from Bulk Deletion above.

Outcome

Deleted categories remain in the system with "Deleted" status but are no longer available for assignment to new markets.

Key Notes

1. Deletion changes status to "Deleted" rather than removing the category entirely.
2. Deleted categories remain visible in the table for historical reference.
3. Markets already assigned to deleted categories retain their classification.
4. Deleted categories cannot be assigned to new markets.
5. The bulk delete count updates dynamically as you select/deselect categories.

6. Searching & Filtering Categories

Purpose

Quickly locate specific categories using real-time search functionality.

When to Use

Use when you need to find categories by name, especially when managing large category lists.

Search Functionality

Feature	Description
Search Box	Real-time text search located in the top toolbar
Search Behavior	Case-insensitive, searches within category names
Results Update	Instant filtering as you type
Clear Filter	Clear filter button appears when search is active

Steps to Search

Step	Action	Details
1	Locate Search Box	Find the Search textbox in the top toolbar.
2	Enter Search Term	Type keywords to filter categories (e.g., "Sports").
3	Review Results	Table automatically updates to show matching categories only.
4	Clear Search	Click the Clear filter button to return to full list.

Outcome

The table displays only categories matching your search term, with the total count updated to reflect filtered results.

Key Notes

1. Search is case-insensitive (e.g., "sports" matches "Sports", "E-Sports").
2. Partial matches are included (e.g., "Sport" finds "Sports" and "E-Sports").
3. Search applies to category names only, not icons or status.
4. The pagination count reflects filtered results (e.g., "1-3 of 3" instead of "1-10 of 11").

7. Column Visibility Management

Purpose

Customize table view by showing or hiding specific columns based on your workflow needs.

When to Use

Use when you need a focused view of specific category information or want to reduce visual clutter.

Available Column Toggles

• Icon
• Name
• isDeleted (Status)
• createdAt (Created At)

Steps to Toggle Columns

Step	Action	Details
1	Click View Button	Click the View button in the top toolbar.
2	Review Column Options	A dropdown menu shows all available columns with checkboxes.
3	Toggle Column Visibility	Click any column checkbox to show or hide it.
4	Close Menu	Click outside the menu or press Escape to close.
5	Verify Changes	Table updates immediately to reflect visibility changes.

Outcome

The table displays only the columns you have checked, allowing for a customized view optimized for your current task.

Key Notes

1. Column visibility changes persist during your session.
2. All columns are visible by default.
3. Name column is essential and should generally remain visible.
4. Changes apply immediately without requiring a save action.

8. Understanding Category Status

Status Types

Status	Display	Description
Active	Active	Category is available for assignment to markets
Deleted	Deleted	Category removed from active use but preserved historically

Status Lifecycle

Categories have a simple two-state lifecycle:

1. Active: Initial status upon creation; category can be assigned to new markets
2. Deleted: Category removed from active use; cannot be assigned to new markets

Key Status Behaviors

1. Active categories appear in category selection dropdowns when creating or editing markets.
2. Deleted categories remain visible in the Categories table for historical tracking.
3. Markets already assigned a deleted category retain that assignment.
4. Deleted categories cannot be assigned to new markets.
5. Status changes are immediate and system-wide.

9. Best Practices for Category Management

Category Creation

1. Use clear, descriptive names that represent broad market themes.
2. Choose meaningful icons that visually represent the category concept.
3. Maintain consistency in naming conventions (e.g., "E-Sports" not "eSports" or "Esports").
4. Avoid creating duplicate or overly similar categories.
5. Consider existing categories before adding new ones to prevent taxonomy bloat.

Category Organization

1. Review the category list regularly to identify redundant or unused categories.
2. Consolidate similar categories before deleting to maintain market organization.
3. Communicate category changes to market creators and operations teams.
4. Document the purpose and scope of each category for team reference.
5. Use the search function to check for existing similar categories before creating new ones.

Deletion Management

1. Review market assignments before deleting a category to understand impact.
2. Consider marking categories as deleted rather than removing them entirely (system behavior).
3. Plan category deletions during low-activity periods when possible.
4. Coordinate with the market operations team before deleting widely-used categories.
5. Use bulk deletion carefully, verifying selections before confirming.

Icon Selection

1. Choose icons from the Lucide icon library that clearly represent the category theme.
2. Maintain visual consistency across related categories.
3. Test icon visibility at different screen sizes before finalizing.
4. Reference the Lucide icon library (lucide.dev/icons) for available options.
5. Avoid using overly complex icons that may not display clearly at small sizes.

10. Category Across System

How Categories Work Across the Platform

1. Market Creation: Categories are assigned when creating or editing markets.
2. User Discovery: Users browse and filter markets by category.
3. Analytics: Category data helps track market distribution and user preferences.
4. Search: Categories improve market searchability and organization.

Category Limitations

1. Each market typically has one primary category assignment.
2. Category changes on existing markets update immediately.
3. Deleted categories cannot be reassigned but remain on existing markets.
4. Icon changes apply to all markets using that category.

Product Glossary

Term	Description
Active	Status indicating the category is available for assignment to markets.
Add Category	Function to create a new market category classification.
Bulk Deletion	Feature allowing multiple categories to be deleted simultaneously using checkboxes.
Category	Primary classification for organizing markets thematically (e.g., E-Sports, Tech, Crypto).
Clear Filter	Button that appears when search is active to remove search criteria and show all categories.
Column Visibility	Feature allowing users to show or hide specific table columns through the View button.
Created At	Timestamp showing when the category was originally created in DD/MM/YYYY HH:MM format.
Deleted	Status indicating the category has been removed from active use but preserved for historical reference.
Edit Category	Function to modify category names and icons for existing classifications.
Icon	Visual representation of the category using Lucide icon library names.
Lucide Icons	Open-source icon library used for category visual representations, accessible at lucide.dev/icons.
Market Categories	System for organizing prediction markets into thematic classifications for improved discovery and navigation.
Name	The display title of the category (e.g., Sports, Economy, Trump).
Pagination	System for dividing category listings into multiple pages with navigation controls.
Rows per Page	Setting controlling how many categories display on each page (options: 5, 10, 25, 50, 100).
Search	Real-time text filtering feature for locating categories by name.
Select All	Checkbox in the table header that selects all visible categories for bulk operations.
Status	Current state of the category: Active (available for use) or Deleted (removed from active use).
View Button	Control for toggling column visibility in the category table.