1. Overview
The BEA Battle Scheduler is a shared tool for managing TikTok PK battle schedules. It connects directly to our Google Sheet, so any changes you make here are visible to everyone on the team in real time.
Key Features
- Dashboard - See all battles at a glance with stats and filters
- Calendar View - Visual monthly calendar with color-coded battles
- Google Calendar - Embedded view of our BEA Battles calendar
- Discord Posts - Generate formatted posts for finding opponents
- Real-time Sync - All changes save to Google Sheets automatically
- Google Calendar Sync - Confirmed battles auto-create timezone-aware calendar events
- Region Color Coding - Blue for US/CA+, Red for UK+ so you always know which region you're in
- Timeframe Views - Toggle between Monthly, 30-Day Rolling, and All Time
Tip: You can access this guide anytime by clicking the ? Help button in the top-right corner of the scheduler.
Tip: The scheduler loads data from Google Sheets when you open it. If someone else made changes, refresh the page to see the latest data.
2. Switching Regions
The scheduler supports two regions, each with their own separate battle data:
- US/CA+ - United States, Canada, and territories (AS, GU, MP, UM, PR, VI)
- UK+ - United Kingdom, Ireland, and associated regions (CD, GB, GG, GI, IE, IM, JE, MT, SJ)
How to switch:
1
Click the US/CA+ or UK+ tab at the top of the page.
How to tell which region you're in:
The entire interface changes color based on the active region:
- Blue = US / Canada + Territories (blue header, blue banner, blue accents)
- Red = UK + Territories (red header, red banner, red accents)
A region banner at the very top of the page always shows the active region name in large text, so there's no confusion about which region you're working in.
Each region has its own:
- Battle data (stored in separate Google Sheet tabs: US_CA and UK)
- Creator roster
- Google Calendar
- Timezone defaults (EST for US, GMT for UK)
Tip: Hover over the country codes next to each region tab to see the full country names. The supported timezones are displayed as pills next to each region.
3. Using the Dashboard
The Dashboard is the default view when you open the scheduler. It shows:
Timeframe Toggle
Above the stats bar, there's a timeframe toggle that controls both the stats and the battle table below:
- Monthly (default) - Shows only battles in the current calendar month
- 30-Day Rolling - Shows battles from today through 30 days out
- All Time - Shows all battles regardless of date
The stats numbers and the table rows both update to match the selected timeframe.
Stats Bar
- Total Battles - How many battles are scheduled (within the selected timeframe)
- Confirmed - Battles with confirmed opponents
- Pending - Battles waiting for confirmation
- Unfilled - Battles that still need an opponent (shown in orange)
- Upcoming (7 days) - Battles happening in the next 7 days
Battle Table
The main table shows all battles with these columns:
- Checkbox - Select battles for bulk Discord posts
- Battle Date - When the battle is scheduled
- Time - Preferred time with timezone
- TikTok Username - Our creator's username (shown in purple)
- Type - Battle type (1 and Done, Best of 3, etc.)
- Power Ups - Whether power-ups are enabled
- Diamonds - Estimated diamond range
- Status - Confirmed or Pending
- vs. - Opponent (clickable link to their TikTok if a URL was provided)
- Network - Creator's network affiliation
- Notes - Additional notes (hover to see full text)
- Actions - Edit, Discord post, and Delete buttons
Sorting
Click any column header to sort by that column. Click again to reverse the sort order.
4. Adding a New Battle
1
Click the + New Battle button in the top-right header.
2
Fill in the form:
- Battle Date - Use the date picker to select a date
- Preferred Time - Use the time picker, then select the timezone from the dropdown (defaults to EST for US, GMT for UK)
- TikTok Username - Start typing to search the creator roster. Click a name to select it, or type a custom name
- vs. Opponent - Paste the opponent's TikTok profile link (e.g., https://www.tiktok.com/@username). Leave blank if no opponent yet
- Battle Type - Select from dropdown (1 and Done, Best of 3, Best of 5, Marathon)
- Power Ups - Yes or No
- Diamond Range - Select the estimated range
- Status - Pending (default) or Confirmed
- Creator Network - The creator's network name if applicable
- Notes - Any extra details (manager name, agency info, etc.)
3
Click Save Battle. The battle will appear in the table and sync to Google Sheets.
Required fields: Battle Date, Preferred Time, and TikTok Username must be filled in. The form will alert you if any are missing.
5. Editing a Battle
1
Find the battle in the table.
2
Click the pencil icon (edit button) in the Actions column on the right.
3
The form will open pre-filled with the battle's current details. Make your changes.
4
Click Save Battle to save. Changes sync to Google Sheets automatically.
6. Changing Battle Status
There's a quick way to toggle status without opening the edit form:
1
Click directly on the Confirmed or Pending badge in the Status column.
2
It will instantly toggle:
- Confirmed → Pending
- Pending → Confirmed
The change saves to Google Sheets automatically. A toast notification will confirm the change.
Calendar sync: When you toggle a battle to Confirmed, a Google Calendar event is automatically created. When you toggle it back to Pending, the event is removed.
7. Deleting a Battle
1
Click the trash icon (red delete button) in the Actions column.
2
A confirmation dialog will ask "Delete this battle?" Click OK to confirm or Cancel to keep it.
Warning: Deleting a battle removes it from the Google Sheet permanently. This cannot be undone.
8. Calendar View
1
Click the Calendar tab (next to Dashboard) at the top of the page.
The calendar shows a monthly grid with battles displayed on their scheduled dates:
- Green = Confirmed battles
- Yellow = Pending battles
Navigation
- Use the left/right arrows to move between months
- Click a battle on the calendar to see its full details in a popup
- Click a date to jump to the Dashboard filtered to that day
9. Google Calendar
1
Click the Google Calendar tab to see the embedded BEA Battles calendar.
This shows the dedicated Google Calendar for the active region:
- US/CA+ tab shows the US/Canada Battles calendar
- UK+ tab shows the UK Battles calendar
Automatic Calendar Sync
Battles are automatically synced to Google Calendar — but only Confirmed battles:
- When a battle is set to Confirmed, a Google Calendar event is created automatically
- When a battle is changed back to Pending, the calendar event is removed
- When a battle is deleted, its calendar event is also removed
- Events are timezone-aware — a battle at 3:00 PM PST will show as 6:00 PM for someone viewing in EST
Each calendar event includes:
- Title: @username vs opponent - TikTok Battle
- Time: Based on the battle date and preferred time
- Description: Battle type, power ups, network, and region
Tip: The embedded calendar view is read-only in the scheduler. Events are managed automatically when you add, edit, or change the status of battles. You can also view the calendar directly in Google Calendar from your browser.
10. Creating a Discord Post
When a battle needs an opponent, you can generate a formatted Discord post to share in matchmaking channels.
1
Find the battle in the table.
2
Click the lightning bolt icon ⚡ in the Actions column.
3
A preview modal opens with the formatted post. It will look like:
🎆 Looking for Battle 🎆
Friday April 24th
10:00 PM EST
@adam.oas
50-75K 💎
All power-ups🥊
1 AND DONE
4
Edit the text if needed - the preview is fully editable.
5
Click Copy to Clipboard and paste it into your Discord channel.
11. Bulk Discord Posts (Multiple Battles)
Need to post several battles at once? Use the bulk selection feature.
1
Select battles using the checkboxes on the left side of each row. Use the checkbox in the header to select all visible battles.
2
The Discord Post (3) button in the toolbar will show how many battles are selected and turn blue when active.
3
Click the button to generate a combined post with all selected battles, separated by divider lines.
4
Edit if needed, then Copy to Clipboard and paste into Discord.
Pro tip: Use the Unfilled filter first to show only battles that need opponents, select all, then generate Discord posts for all of them at once.
12. Managing Creators
The creator roster is the list of TikTok usernames that appear in the dropdown when adding a battle. Each region has its own roster.
To manage the roster:
1
Click Manage Creators in the top header bar.
2
A panel opens showing all creators for the current region.
To add a creator:
1
Type the username in the input field at the top (no @ needed).
2
Click Add. The creator will be added to the roster and synced to Google Sheets.
To remove a creator:
1
Click the X button next to their name.
Note: Make sure you're on the correct region tab (US/CA+ or UK+) before managing creators. Each region has a separate roster stored in the "Creators" tab of the Google Sheet.
13. Searching and Filtering
Status Filters
Use the filter buttons above the table:
- All - Show all battles
- Confirmed - Only confirmed battles
- Pending - Only pending battles
- Unfilled - Only battles without an opponent assigned
Username Search
Type in the search box to filter by creator username or opponent name. Results update as you type.
Date Range
Use the two date fields to filter battles within a specific date range:
- First date field = From date
- Second date field = To date
Clear both fields to show all dates again.
14. Export and Import
Export CSV
Click Export CSV to download the current region's battle data as a CSV file. Useful for backups or sharing data outside the scheduler.
Import CSV
Click Import CSV to upload a CSV file and add battles in bulk. The CSV should have columns matching the battle fields (Timestamp, Battle Date, Preferred Time, Username, Battle Type, Power Ups, Diamond Range, Status, Notes, Opponent, Network).
Important: Importing adds battles to the existing list - it does not replace them. Duplicate checking is not automatic, so review your data before importing.
15. FAQ / Troubleshooting
The page shows "Loading battles..." and nothing appears
This usually means the Google Sheets connection is slow. Wait a few seconds. If it persists, refresh the page. Check your internet connection.
I made a change but my teammate doesn't see it
Changes save to Google Sheets immediately, but other users need to refresh their page to see updates. There is no auto-refresh - each person sees the data as of when they last loaded or refreshed.
The creator dropdown doesn't show names
Make sure you're clicking inside the "TikTok Username" field and typing. The dropdown appears when you focus on the field. If names are missing, use Manage Creators to add them.
I accidentally deleted a battle
Unfortunately, deletes are permanent. You can check the Google Sheet's version history (File > Version history > See version history) to recover the data, then re-add the battle manually.
The opponent link doesn't work
Make sure the opponent field contains a full TikTok URL starting with https://www.tiktok.com/@. Plain usernames will display as text but won't be clickable.
How do I add a new timezone?
The available timezones are pre-set for each region. If you need a timezone that's not listed, contact the admin to update the scheduler code.
Can multiple people edit at the same time?
Yes! Everyone reads from and writes to the same Google Sheet. However, if two people edit the same battle at the same time, the last save wins. This is rare in practice.