How to Understand Drill Scopes: Global, Club, and Private

Intro

In BallersBook, every drill you see in the Drill Library belongs to one of several visibility scopes. Understanding the difference between Global, Club, and Private drills is key to knowing who can view, edit, or delete them. This guide explains the scopes we currently support, how to tell them apart, and what permissions apply.

Prerequisites

• An authenticated BallersBook account (Club Admin, Coach, or other role with drill management permissions).
• Access to the Drill Library (/library or /drills).
• Familiarity with the Global vs. Club Toggle feature (available to Club Admins).

Step-by-step

1. Navigate to the Drill Library. Click Drills in the main navigation (or go directly to /library). You see a grid of drill cards.

2. Identify the scope of a drill by checking its source:

• Global drills have the string "global" as their club_id in the database. These are system-created drills that every club can see.
• Club drills are drills created by users in your club. Their club_id matches your club’s unique ID.

3. Toggle between Global and Club views (Club Admins only):

• At the top of the library, find the Global vs. Club Toggle button.
• Click it to switch between viewing all Global drills or only your club’s drills.
• This toggle is hidden for guest users and roles without manage_drills permission.

4. View drill details to confirm scope:

• Click View Details on any drill card. A modal opens.
• In the modal, you may see tags or metadata indicating the scope. Global drills often have a “Global” badge; club drills show your club name.
• Guest users can only see Global drills; any attempt to copy or edit triggers a signup prompt.

5. Who can modify each scope?

• Global drills: Only system super‑admins (not described in our docs) can edit or delete. Club users cannot modify them - they are read‑only.
• Club drills: Any authenticated user with the manage_drills permission (typically Club Admins and Coaches) can edit, delete, or copy these drills.
• Private drills: Our documentation does not currently describe a distinct “Private” scope. If you see a drill that appears to be private (visible only to you), it is likely a club drill filtered by your user’s permissions or a future feature not yet documented. Please contact support for clarification.

6. Create a new drill with the correct scope:

• Click New Drill (requires manage_drills permission).
• When you save the drill, it is automatically assigned to your club (club_id set to your club’s ID). Global drill creation is restricted to super‑admins.

Tips & Pitfalls

• Guest users can only browse Global drills. If you want guests to see your club’s drills, consider making them Global (requires super‑admin approval) or sharing a public link via the share feature (/share/:id).
• Copying a club drill creates a duplicate that belongs to your club, even if the original was Global. The copy will have “(Copy)” appended to its name.
• If you cannot see the Global vs. Club Toggle, check your role. It is hidden for ai-reviewer, ai-admin-reviewer, and guest accounts.
• Deleting a club drill is permanent. There is no recycle bin. Confirm before deleting.

Summary

You now know the two documented drill scopes in BallersBook: Global (system‑wide, read‑only to clubs) and Club (owned by your club, editable by authorized users). The Private scope is currently not documented in our reference materials; we recommend reaching out to support if you need private drill functionality. Next, try creating a club drill or exploring the Drill Library with the Global/Club toggle to see the difference in action.