Skip to Content
User GuidesProject Management Guide - Miniback Documentation

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

PlanProject Limit
FREE1
STARTER10
PROUnlimited

Create New Project

  1. Go to Projects page
  2. Click “Create Project” button
  3. Enter project name
  4. Click “Create”
  5. 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:

  1. Go to project details page
  2. Scroll to “Danger Zone”
  3. Click “Pause Project”
  4. Confirm action
  5. Project status changes to PAUSED

Batch pause:

  1. Go to Projects page
  2. Enable batch selection (checkbox icon)
  3. Select multiple projects
  4. Click “Pause Selected”
  5. 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:

  1. Go to project details page
  2. Scroll to “Danger Zone”
  3. Click “Unpause Project”
  4. Project reactivates immediately
  5. Widget starts accepting feedback again

Batch unpause:

  1. Enable batch selection
  2. Select paused projects
  3. Click “Unpause Selected”
  4. 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:

  1. Go to project details page
  2. Scroll to “Danger Zone”
  3. Click “Delete Project”
  4. Confirmation modal appears
  5. Read warning carefully
  6. Type project name to confirm (if required)
  7. Click “Delete Project”

Batch delete:

  1. Enable batch selection
  2. Select projects to delete
  3. Click “Delete Selected”
  4. Confirmation modal shows all projects
  5. Review list carefully
  6. 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:

  1. Go to feedback page
  2. Export all feedback to CSV
  3. Save file to safe location
  4. 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

  1. Go to Projects page
  2. Click checkbox icon in toolbar
  3. Checkboxes appear on project cards
  4. 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:

  1. Pause unused projects (doesn’t free slot on FREE)
  2. Delete old projects (frees slot immediately)
  3. 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 SettingsBilling:

  • 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 - Development

By product:

Main Website Mobile App - iOS Mobile App - Android Beta Features

By customer:

Client A - Dashboard Client B - Dashboard Internal Tools

Best 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

  1. Go to project details
  2. Click “Edit” next to project name
  3. Enter new name
  4. Click “Save”
  5. Slug remains unchanged (cannot edit)

Note: Slug stays the same to maintain widget integration. Only name changes.

Common Workflows

Testing New Features

  1. Create “Beta Testing” project
  2. Configure widget
  3. Deploy to staging
  4. Collect feedback
  5. After testing: Export data → Delete project

Migrating Projects

From old to new:

  1. Create new project with updated config
  2. Export feedback from old project
  3. Deploy new widget code
  4. Pause old project (temporary)
  5. Verify new project working
  6. Delete old project after confirmation period

Seasonal Projects

Black Friday feedback example:

  1. Create “Black Friday 2025” project
  2. Deploy during event
  3. Collect focused feedback
  4. Export analytics after event
  5. Pause or delete after analysis

Client Projects

Agency use case:

  1. Create project per client
  2. Isolated feedback
  3. Custom widget branding
  4. Separate API keys
  5. 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?


Need help? See Troubleshooting or contact support.

Last updated on