Project Setup
Create and configure analytics projects
Project Setup
Projects in Bklit represent individual applications or websites you want to track.
Creating a Project
During Onboarding
- Enter project name
- (Optional) Enter project domain
- Click "Create" or "Next"
After Onboarding
- Go to workspace dashboard
- Click "Create Project" or "+"
- Fill in project details
- Click "Create"
Project Details
Project Name
- Required field
- Descriptive name for your project
- Example: "Production Website", "Mobile App"
Project Domain
- Optional but recommended
- Used for domain validation
- Example:
example.com,app.example.com
Benefits:
- Domain-based filtering
- Automatic domain detection
- Better data organization
Project Limits
Free Plan
- 1 project per workspace
Pro Plan
- 5 projects per workspace
Super Admin
- Unlimited projects
Project Features
Analytics Dashboard
- View page views
- Track sessions
- Monitor events
- View funnels
API Access
- Generate API tokens
- Scope tokens to projects
- Track events via API
Event Definitions
- Define custom events
- Set up conversion funnels
- Track user interactions
Project Settings
Access project settings:
- Go to project dashboard
- Click "Settings" in sidebar
- Manage project configuration
Available Settings
- General - Name, domain
- API Tokens - Token management
- Events - Event definitions
- Funnels - Conversion funnels
Project ID
Each project has a unique ID:
- Format: CUID (e.g.,
cmic3a5ap0003zxfjshgs688w) - Used in API requests
- Required for SDK integration
- Found in project settings
Best Practices
Naming
- Use descriptive names
- Include environment (Production, Staging)
- Match application name
Organization
- One project per application
- Separate projects for different environments
- Use workspaces to group related projects
Domain Configuration
- Always set project domain
- Use exact domain (include www if needed)
- Update if domain changes
Project Management
Viewing Projects
- List all projects in workspace
- Filter by name or domain
- Sort by creation date
Editing Projects
- Update project name
- Change project domain
- Modify settings
Deleting Projects
⚠️ Warning: Deleting a project:
- Permanently removes all analytics data
- Cannot be undone
- All associated tokens are revoked
Before deleting:
- Export any needed data
- Verify you want to delete
- Confirm deletion
Troubleshooting
Can't Create Project
- Check workspace project limit
- Verify you have admin/owner role
- Check for account restrictions
Project Not Tracking
- Verify project ID is correct
- Check API token has project access
- Verify domain matches (if set)
- Check SDK integration
Wrong Project Data
- Verify project ID in SDK
- Check token project scoping
- Review domain configuration
Related Documentation
- Workspace Setup - Creating workspaces
- SDK Integration - Integrating the SDK
- API Tokens - Managing API tokens