Project Management Guide
Learn how to organize, pause, delete, and manage multiple Miniback projects efficiently.
Understanding Projects
What is a Project?
A project in Miniback represents:
- A unique feedback collection point
- Independent widget configuration
- Separate feedback database
- Individual API key
- Isolated analytics
Example projects:
- “Company Website”
- “Mobile App”
- “Beta Feature”
- “Customer Portal”
Project States
ACTIVE (Green)
- Collecting feedback
- Widget working
- API accessible
- Analytics updating
PAUSED (Yellow)
- NOT collecting feedback
- Widget displays “paused” message
- Existing feedback preserved
- Settings locked
Creating Projects
Project Limits by Plan
| Plan | Project Limit |
|---|---|
| FREE | 1 |
| STARTER | 10 |
| PRO | Unlimited |
Create New Project
- Go to Projects page
- Click “Create Project” button
- Enter project name
- Click “Create”
- Project created with auto-generated slug
Slug generation:
- Automatically created from project name
- Example: “My Website” →
my-website - Cannot be changed after creation (data consistency)
Project Name Requirements
Valid names:
My Website ✅
Mobile App (iOS) ✅
Beta Testing - v2.0 ✅Best practices:
- Descriptive and clear
- Include environment if applicable
- Use consistent naming scheme
Viewing Projects
Projects List
Shows all your projects with:
- Project name
- Status (Active/Paused)
- Feedback count
- Creation date
- Quick action buttons
Sorting & Filtering
Sort by:
- Name (A-Z or Z-A)
- Created date (newest/oldest)
- Feedback count (high/low)
Filter:
- Include/exclude paused projects
- Search by project name
Clear filters:
- Reset to default view
Pausing Projects
Why Pause?
Pause when you need to:
- Temporarily stop feedback collection
- Maintain project but disable widget
- Preserve data while inactive
- Free up project slot (within limits)
- Prevent spam on old projects
How to Pause
Single project:
- Go to project details page
- Scroll to “Danger Zone”
- Click “Pause Project”
- Confirm action
- Project status changes to PAUSED
Batch pause:
- Go to Projects page
- Enable batch selection (checkbox icon)
- Select multiple projects
- Click “Pause Selected”
- Confirm action
What Happens When Paused
Immediately disabled:
- ❌ Widget stops accepting feedback
- ❌ API submissions rejected
- ❌ Widget customization locked
- ❌ Domain settings locked
- ❌ API key regeneration disabled
Still accessible:
- ✅ View existing feedback
- ✅ View analytics
- ✅ Export feedback to CSV
- ✅ View project settings (read-only)
Widget behavior:
- Shows “This project is temporarily paused” message
- Button appears grayed out/disabled
- No form submission possible
Unpausing Projects
Single project:
- Go to project details page
- Scroll to “Danger Zone”
- Click “Unpause Project”
- Project reactivates immediately
- Widget starts accepting feedback again
Batch unpause:
- Enable batch selection
- Select paused projects
- Click “Unpause Selected”
- Projects reactivate immediately
No data loss:
- All feedback preserved
- Settings restored
- Widget configuration intact
Deleting Projects
Why Delete?
Delete projects that:
- Are no longer needed
- Were created for testing
- Have migrated to new setup
- Need to free project slots (FREE/STARTER plans)
How to Delete
Single project:
- Go to project details page
- Scroll to “Danger Zone”
- Click “Delete Project”
- Confirmation modal appears
- Read warning carefully
- Type project name to confirm (if required)
- Click “Delete Project”
Batch delete:
- Enable batch selection
- Select projects to delete
- Click “Delete Selected”
- Confirmation modal shows all projects
- Review list carefully
- Confirm deletion
What Gets Deleted
Permanently removed:
- ❌ Project record
- ❌ All feedback data
- ❌ Widget configuration
- ❌ API key
- ❌ Domain settings
- ❌ Analytics data
Cannot be recovered:
- ⚠️ Deletion is permanent
- ⚠️ No “undo” option
- ⚠️ No backup restoration
Before Deleting
Export your data:
- Go to feedback page
- Export all feedback to CSV
- Save file to safe location
- Consider exporting analytics screenshots
Notify team:
- Inform team members
- Update documentation
- Remove widget from website first
Alternative: Pause instead
- Consider pausing if might need later
- Preserves all data
- Can reactivate anytime
Batch Operations
Enabling Batch Selection
- Go to Projects page
- Click checkbox icon in toolbar
- Checkboxes appear on project cards
- Select projects individually or “Select All”
Available Batch Actions
Pause Selected:
- Pauses all selected projects
- Shows count: “Pause 3 projects”
- Confirmation dialog
Unpause Selected:
- Activates all selected projects
- Shows count: “Unpause 5 projects”
- Immediate action
Delete Selected:
- Permanently deletes selected projects
- Shows project names in confirmation
- Requires careful review
Selection Tips
Select All:
- Selects all visible projects
- Respects current filters
- Only current page (if paginated)
Deselect All:
- Clears all selections
- Start fresh
Selective:
- Click individual checkboxes
- Build custom selection
- Mix and match
Project Limits
At Limit (FREE/STARTER)
What happens:
- “Create Project” button disabled
- Error message: “Project limit reached”
- Must pause or delete existing projects
Solutions:
- Pause unused projects (doesn’t free slot on FREE)
- Delete old projects (frees slot immediately)
- Upgrade plan (instant increase)
Paused projects count:
- FREE: Paused projects count toward limit
- STARTER: Paused projects count toward limit
- PRO: Unlimited, paused projects don’t matter
Checking Usage
Go to Settings → Billing:
- Shows “Projects: 3 / 10” (example)
- Red when at/near limit
- Green when under limit
Organizing Projects
Naming Conventions
By environment:
Website - Production
Website - Staging
Website - DevelopmentBy product:
Main Website
Mobile App - iOS
Mobile App - Android
Beta FeaturesBy customer:
Client A - Dashboard
Client B - Dashboard
Internal ToolsBest Practices
Separate environments:
- Different projects for dev/staging/prod
- Isolates test feedback
- Cleaner analytics
Descriptive names:
- Clear purpose
- Easy to identify
- Team-friendly
Regular cleanup:
- Monthly review
- Delete test projects
- Pause inactive projects
- Export before deleting
Project Settings
What You Can Configure
Per project:
- Project name
- Widget appearance
- Widget behavior
- Allowed domains
- API key
- Project status
Editing Project Name
- Go to project details
- Click “Edit” next to project name
- Enter new name
- Click “Save”
- Slug remains unchanged (cannot edit)
Note: Slug stays the same to maintain widget integration. Only name changes.
Common Workflows
Testing New Features
- Create “Beta Testing” project
- Configure widget
- Deploy to staging
- Collect feedback
- After testing: Export data → Delete project
Migrating Projects
From old to new:
- Create new project with updated config
- Export feedback from old project
- Deploy new widget code
- Pause old project (temporary)
- Verify new project working
- Delete old project after confirmation period
Seasonal Projects
Black Friday feedback example:
- Create “Black Friday 2025” project
- Deploy during event
- Collect focused feedback
- Export analytics after event
- Pause or delete after analysis
Client Projects
Agency use case:
- Create project per client
- Isolated feedback
- Custom widget branding
- Separate API keys
- Individual analytics
Mobile & Tablet View
Projects page is mobile-responsive:
Mobile features:
- Card-based layout
- Swipe gestures
- Touch-friendly buttons
- Filter drawer
- Batch selection adapted
Touch actions:
- Tap to view details
- Long press for batch select
- Swipe for quick actions
Troubleshooting
Can’t create project:
- Check plan limit in Settings → Billing
- Delete or pause unused projects
- Upgrade plan if needed
Project not pausing:
- Refresh page and try again
- Check if already paused
- Clear browser cache
Batch actions not working:
- Ensure projects are selected (checkboxes)
- Try smaller batch (< 20 projects)
- Refresh page and retry
Deleted project still showing:
- Refresh page (Ctrl+F5)
- Clear browser cache
- Sign out and sign in
What’s Next?
- Widget Customization - Configure widget appearance
- Domain Management - Secure your projects
- Billing - Upgrade for more projects
Need help? See Troubleshooting or contact support.