Project Settings

Configure advanced project features, notifications, and integrations for optimal workflow management.

General Settings

Project Information

Basic Details:

• Project Name - Display name visible to all members
• Description - Detailed project information
• Project Icon - Visual identifier for your project
• Project URL - Custom URL slug (if available)

Visibility Settings:

• Public - Listed in project directory, anyone can join
• Private - Invitation-only access, not publicly listed

Module Configuration

Enable or disable project modules based on your needs:

Core Modules:

• Bugs - Technical issue reporting and tracking
• Suggestions - Feature requests and improvements
• Tickets - General support and help requests

Advanced Modules:

• Sentiment Analysis - Community mood monitoring
• Support Knowledge Base - AI-powered support documentation
• Game Facts - Enhanced AI context for better processing

Bug Reporting Settings

Description Validation Levels:

• AI Check - AI evaluates and provides feedback on report quality
• Minimum Character Limit - Require minimum description length (default: 50 characters)
• No Check - Accept reports without validation

AI Enhancement Settings:

• Duplicate Detection - Automatically identify similar reports
• Priority Assignment - AI-generated priority based on content
• Tag Suggestion - Automatic tag assignment based on description

User Management

Role Configuration

Define access levels for different user types:

Developer Role:

• Full access to all project features
• Can manage project settings and members
• Counted for billing purposes
• Can delete and modify any content

Support Role:

• Full access to tickets module
• Limited access to bugs and suggestions
• Not counted for billing (recognizing volunteer support)
• Can moderate discussions and provide assistance

Tester Role:

• Can submit bugs, suggestions, and tickets
• View permissions based on project settings
• Cannot modify project configuration
• Limited administrative capabilities

Member Visibility Settings

Control what project members can see:

All Reports Visible:

• Members can see all bugs, suggestions, and tickets
• Encourages collaboration and transparency
• Suitable for open development processes

Own Reports Only:

• Members only see their own submissions
• Provides privacy for sensitive projects
• Reduces information overload

Custom Visibility:

• Configure visibility per module type
• Set different rules for bugs vs. suggestions
• Define role-based viewing permissions

Notification Configuration

Developer Notifications

Configure what notifications you receive as a project owner:

Notification Levels:

• Do Not Notify - Only receive notifications when directly mentioned
• Instant Notifications - Immediate alerts for new bugs, features, and releases
• Instant + Auto-Watch - Get notifications and automatically watch new items

Notification Types:

• New Submissions - Bug reports, suggestions, tickets
• Status Changes - Updates to existing items
• Comments - New discussions on items
• Assignments - When items are assigned to you

Delivery Methods

Email Notifications:

• Configure email frequency (instant, daily digest, weekly summary)
• Set email templates and formatting
• Manage subscription preferences

Discord Integration:

• Direct message notifications for important updates
• Channel notifications for team-wide announcements
• Custom notification channels for different event types

Tester Notifications

Default Settings for New Members:

• Release Announcements - Automatically notify about new versions
• Report Updates - Notifications when their reports are updated
• Project News - Important project announcements

Customization Options:

• Members can adjust their own notification preferences
• Opt-out options for specific notification types
• Integration with external notification systems

Issues Configuration

Tags Management

Create and organize tags for better issue categorization:

Hierarchical Structure:

• Main Tags - Broad categories (Performance, Graphics, Gameplay)
• Sub-Tags - Specific issues within main categories
• Color Coding - Visual organization and quick identification

Default Tag Sets: BetaHub provides default tags for common game issues:

• Performance (Crash, Freeze, FPS Drop, Memory Leak)
• Graphics (Rendering, Texture, Lighting, UI)
• Audio (Sound Effects, Music, Voice, Audio Lag)
• Gameplay (Balance, Mechanics, Progression, Controls)
• Network (Connection, Lag, Sync, Disconnection)

Custom Tags:

• Create project-specific tags for unique systems
• Define importance levels and routing rules
• Set up automatic assignment based on keywords

Priority System

Default Priorities:

• Critical - Game-breaking issues, crashes, data loss
• High - Major functionality problems, significant user impact
• Medium - Moderate issues, workarounds available
• Low - Minor issues, cosmetic problems, enhancements

Custom Priority Rules:

• Define project-specific priority criteria
• Set up automatic assignment based on content analysis
• Create escalation rules for time-sensitive issues

Auto-Archiving

Keep your project clean with automatic issue archiving:

Archiving Rules:

• Time-Based - Archive issues after specified periods of inactivity
• Status-Based - Archive when certain statuses are maintained
• Tag-Based - Archive based on specific tag combinations

Archive Settings:

• Archive After - Days of inactivity before archiving
• Excluded Statuses - Statuses that prevent archiving
• Notification - Alert before archiving items

Archive Management:

• Archived items remain searchable and accessible
• Can be restored manually if needed
• Maintain audit trail of archiving actions

Custom Issue Fields

Enhance your bug reporting with customizable fields that collect project-specific information from testers.

Overview

Custom Issue Fields allow you to collect additional structured information beyond the standard bug report format. Create fields for specific game systems, player data, or any information that helps prioritize and resolve issues effectively.

Key Benefits:

• Structured Data Collection - Gather consistent information across all reports
• Enhanced Bug Triage - Use custom fields for better priority assignment
• Project-Specific Context - Collect game or system-specific details
• Flexible Permissions - Control who can see and edit different fields

Field Types

Choose from four field types to match your data collection needs:

Text Input:

• Free-form text responses
• Ideal for descriptions, version numbers, or detailed information
• Supports validation rules and character limits

Yes/No Checkbox:

• Simple boolean questions
• Perfect for feature toggles, reproduction status, or binary conditions
• Clear true/false data for analysis

Single Choice Dropdown:

• Select one option from a predefined list
• Useful for categories, difficulty levels, or platform selection
• Consistent data entry and easy filtering

Multiple Choice (Checkboxes):

• Select multiple options from a list
• Great for affected systems, feature combinations, or multi-factor issues
• Comprehensive data capture for complex scenarios

Permission Model

Control field visibility and editing with two permission settings:

Tester Settable:

• Determines if testers can fill out the field during bug submission
• Must be enabled for required fields
• Allows community-driven data collection

Tester Viewable:

• Controls if testers can see field values in bug reports
• Independent of settable permissions
• Useful for internal-only fields or sensitive information

Permission Combinations:

• Settable + Viewable - Full community participation
• Settable Only - Collect data but keep responses private
• Viewable Only - Display developer-set values to community
• Neither - Internal developer fields only

Creating Custom Fields

Access Custom Fields:

1. Navigate to your project settings
2. Click Custom Fields in the sidebar menu
3. View existing fields or create new ones

Field Creation Process:

1. Click New Custom Field
2. Enter a unique field name
3. Select the field type
4. Configure permissions (tester_settable, tester_viewable)
5. Set field as required (optional)
6. Add options for select fields
7. Save the field configuration

Validation Rules:

• Field names must be unique within the project
• Required fields must be tester_settable
• Single-select and multi-select fields require at least one option
• Field names are required and cannot be empty

Field Configuration Options

For All Field Types:

• Field Name - Descriptive label shown to users
• Required - Force completion before bug submission
• Tester Settable - Allow testers to fill the field
• Tester Viewable - Display field values to testers

For Select Fields (Single/Multiple Choice):

• Options List - Define available choices
• Option Management - Add, remove, or reorder options
• Default Selections - Pre-select common options

Device Field Requirements

Configure whether bug submissions must include device information:

Device Requirement Setting:

• Checkbox - “Require device information for bug submissions”
• Scope - Only affects web interface submissions
• Discord Bot - This setting does not apply to Discord bot submissions
• Validation - Prevents submission without device selection when enabled

Implementation:

• Enable in project settings under “Required Fields”
• Enforced during web-based bug submission process
• Displays clear error messages when device info is missing

User Interface Improvements

Custom fields integrate seamlessly with BetaHub’s clean interface design:

Form Enhancements:

• Tooltip System - Contextual help without cluttering forms
• Required Field Indicators - Clear asterisk (*) marks within labels
• Dynamic Elements - Options show/hide based on field type selection
• Responsive Design - Optimized for all device sizes

User Experience:

• Intuitive Navigation - Clear path to field management
• Real-time Validation - Immediate feedback on field configuration
• Error Prevention - Validation rules prevent configuration mistakes

Integration with Bug Workflow

Custom fields enhance the existing bug reporting process:

During Bug Submission:

• Fields appear in submission forms based on permissions
• Required fields block submission until completed
• Validation ensures data quality and completeness

In Bug Reports:

• Field values display according to visibility settings
• Filterable and searchable like standard bug attributes
• Included in export and integration data

For Developers:

• Use field data for enhanced bug triage
• Filter and sort by custom field values
• Include in automated workflows and integrations

Access Control and Security

Role-Based Management:

• Only developers can create, edit, and delete custom fields
• Support and tester roles cannot modify field configurations
• Full audit trail of field management actions

Data Protection:

• Field visibility respects project privacy settings
• Custom field data included in data export capabilities
• Secure handling of sensitive information

Best Practices

Field Design:

• Use clear, descriptive field names
• Provide helpful option lists for select fields
• Consider the tester experience when designing fields
• Start with essential fields and expand gradually

Permission Strategy:

• Make fields tester_settable when community input is needed
• Use tester_viewable to show context without cluttering forms
• Consider internal-only fields for sensitive information

Workflow Integration:

• Design fields that enhance your bug triage process
• Align field options with your development workflow
• Use required fields sparingly to avoid submission barriers

Troubleshooting

Common Issues:

• Field Not Appearing - Check tester_settable permissions
• Cannot Save Required Field - Ensure field is tester_settable
• Missing Options - Verify select fields have defined options
• Validation Errors - Review field name uniqueness and required settings

Configuration Problems:

• Duplicate Names - Field names must be unique per project
• Permission Conflicts - Required fields must allow tester input
• Empty Options - Select fields require at least one option

Integration Settings

Discord Bot Configuration

Basic Setup:

• Bot Token - Unique identifier for your project’s bot
• Permissions - Required Discord permissions for functionality
• Channel Configuration - Primary channels for different activities

Reporting Settings:

• Bug Channel - Where bug reports are posted
• Support Channels - Additional channels for support requests
• Notification Channel - Dedicated channel for bot announcements

Advanced Features:

• Listen Mode - AI-powered automatic bug detection in conversations
• Thread Mode - Create discussion threads for each report
• Custom Messages - Personalize bot responses and notifications

External Tool Integrations

Project Management:

• Jira - Sync issues with Jira projects
• Asana - Create tasks from bug reports
• GitHub - Open GitHub issues automatically
• Monday.com - Integrate with Monday boards

Communication:

• Slack - Send notifications to Slack channels
• Microsoft Teams - Teams integration for enterprise users
• Webhook URLs - Custom webhook endpoints for real-time updates

Development Tools:

• CI/CD Integration - Trigger builds and deployments
• Version Control - Link commits to bug reports
• Testing Frameworks - Automatic test result reporting

Advanced Features Configuration

Game Facts

Enhance AI understanding with game-specific context:

Game Information:

• Genre and Mechanics - Help AI understand game type and systems
• Critical Systems - Define which parts of the game are most important
• Terminology - Create a glossary of game-specific terms
• Priority Rules - Custom rules for issue importance

AI Enhancement:

• Improved Tagging - More accurate automatic tag assignment
• Better Prioritization - Context-aware priority assignment
• Enhanced Descriptions - AI-generated titles and descriptions

Support Knowledge Base

Document Management:

• Upload Documents - PDF, TXT, MD files for knowledge base
• Content Organization - Structure documents for optimal AI retrieval
• Version Control - Track changes and updates to knowledge

AI Configuration:

• Search Sensitivity - Adjust how closely AI matches queries
• Response Style - Configure AI response tone and format
• Fallback Behavior - What happens when AI can’t find answers

Performance Monitoring:

• Query Analytics - Track what users are asking about
• Knowledge Gaps - Identify missing information
• Success Metrics - Measure knowledge base effectiveness

Sentiment Analysis

Channel Configuration:

• Monitored Channels - Select Discord channels to analyze
• Analysis Frequency - How often to process messages
• Sentiment Categories - Define custom sentiment classifications

Dashboard Settings:

• Reporting Periods - Default time ranges for analysis
• Alert Thresholds - Trigger notifications for negative sentiment
• Visualization Options - Configure charts and displays

Security and Privacy

Access Control

IP Restrictions:

• Limit access to specific IP ranges (Enterprise feature)
• Configure VPN requirements for sensitive projects
• Set up geographic access controls

Authentication Requirements:

• Two-Factor Authentication - Require 2FA for all members
• Single Sign-On - Integration with corporate SSO systems
• Session Management - Configure session timeouts and policies

Data Protection

Data Retention:

• Automatic Cleanup - Remove old data according to policies
• Export Capabilities - Regular data exports for backup
• Deletion Procedures - Secure data deletion when needed

Privacy Controls:

• Anonymization Options - Remove personal data from reports
• GDPR Compliance - Tools for GDPR compliance management
• Data Processing Agreements - Configure data handling agreements

Performance and Monitoring

Analytics Configuration

Project Metrics:

• Bug Resolution Time - Track average time to resolution
• Member Activity - Monitor participation and engagement
• Integration Usage - Track external tool usage patterns

Custom Dashboards:

• Key Performance Indicators - Define project-specific KPIs
• Report Scheduling - Automatic report generation and delivery
• Alerting - Notifications for metric thresholds

Resource Management

Storage Limits:

• File Upload Limits - Maximum file sizes for attachments
• Archive Storage - Long-term storage policies
• Cleanup Automation - Automatic removal of old files

Performance Optimization:

• Caching Settings - Configure caching for better performance
• API Rate Limits - Manage API usage and throttling
• Resource Monitoring - Track project resource usage

Backup and Recovery

Data Backup

Automatic Backups:

• Daily Backups - Automatic daily project data backup
• Incremental Backups - Efficient storage of changes
• Backup Retention - How long to keep backup copies

Manual Backup:

• Export Functions - Manual data export capabilities
• Selective Backup - Choose specific data to backup
• Format Options - Multiple export formats available

Disaster Recovery

Recovery Procedures:

• Point-in-Time Recovery - Restore to specific timestamps
• Selective Recovery - Restore specific components or data
• Recovery Testing - Regular testing of recovery procedures

Getting Help

Configuration Support

Documentation:

• Step-by-step configuration guides
• Best practices for different project types
• Troubleshooting common setup issues

Community Resources:

• Join our Discord server for configuration help
• Share configuration examples with other users
• Get advice from experienced project managers

Professional Support:

• Enterprise customers get dedicated configuration support
• Professional services for complex setup requirements
• Training sessions for team configuration management

Migration Assistance

From Other Platforms:

• Migration tools for common bug tracking systems
• Data import utilities for existing projects
• Configuration mapping from other tools

Project Transfers:

• Move projects between organizations
• Merge multiple projects into one
• Split large projects into smaller ones

Next Steps

• API Access - Set up programmatic access to your configured project
• Integrations - Connect your configured project with external tools
• Advanced Features - Explore the features you’ve configured