Welcome back! 👋
🔔

📖 MessMass User Guide

Complete guide for using MessMass event statistics dashboard

🚀 Getting Started

Accessing Your Event Dashboard

MessMass provides different ways to access your event statistics:

  • Admin Login: Full access to create, edit, and manage projects
  • View Link: Public stats page for viewing completed event data
  • Edit Link: Live tracking page for collecting data during events

Event Selection

Once logged in, you can select events from the Projects page. Each event has:

  • Event Name: Unique identifier for the event
  • Event Date: When the event took place
  • Hashtags: Categories and labels for organization

📊 Understanding the Stats Page

Reading Charts

The stats page displays your event data in visual charts:

  • Pie Charts: Show proportional breakdowns (gender, age groups)
  • Bar Charts: Compare different categories side by side
  • KPI Cards: Display key numbers at a glance

Chart Layout

Row 1: Merchandise | Engagement | Value
Row 2: Gender Distribution | Age Groups
Row 3: Location | Sources

Interactive Features

  • Click on chart segments for detailed breakdowns
  • Hover over elements to see exact numbers
  • Export charts as PNG images using the download button

⚡ Live Event Tracking

Using the Edit Page

During live events, use the edit page to collect real-time statistics:

Clicker Mode

  • Quick increment/decrement buttons for fast data entry
  • Perfect for high-traffic events
  • Real-time updates visible to all viewers

Manual Mode

  • Enter exact numbers when you have accurate counts
  • Useful for post-event data entry
  • Includes fields for success manager metrics

Safety Tips

  • Save frequently to prevent data loss
  • Use the undo feature if you make a mistake
  • Multiple people can track simultaneously

💾 Exporting Data

CSV Export

Export your data to CSV for analysis in Excel or Google Sheets:

  • Includes all collected metrics
  • Timestamps in ISO 8601 format (UTC)
  • Easy to import into other tools

PDF Export

  • Professional reports with charts
  • Ready to share with stakeholders
  • Preserves visual formatting

Chart Images

  • Download individual charts as PNG
  • High quality for presentations
  • Click the download icon on any chart

🔗 Sharing Results

Creating Share Links

Generate shareable links for your event statistics:

  • Public Links: Anyone with the link can view
  • Password Protected: Require a password for access
  • Time-Limited: Set expiration dates for sensitive data

Managing Access

  • View who has accessed your shared links
  • Revoke access at any time
  • Update passwords without changing the link

📈 Understanding Metrics

Image Categories

  • Remote Images: Photos taken by professional photographers
  • Hostess Images: Photos with event staff/ambassadors
  • Selfies: Self-taken photos by attendees

Demographics

  • Gender: Male/Female distribution
  • Age Groups: Gen Alpha, Gen Y/Z, Gen X, Boomer

Location Types

  • Indoor: Covered venues
  • Outdoor: Open-air events
  • Stadium: Sports venues

Merchandise Tracking

  • Merched: Attendees wearing team merchandise
  • Jersey: Official team jerseys
  • Scarf: Team scarves
  • Flags: Team flags
  • Baseball Cap: Team caps
  • Other: Other branded items

Core Fan Team Metric

Calculated as: (Merched Fans / Total Fans) × Event Attendees

This metric estimates the number of engaged fans who attend events and show their support through merchandise.

🏷️ Hashtag System

Traditional Hashtags

  • Simple text labels for organizing events
  • Example: #soccer, #concert, #festival
  • Filter events by hashtags in the admin panel

Category-Prefixed Hashtags

Advanced organization with categories:

  • Format: category:hashtag
  • Example: country:france, year:2024
  • Color Coding: Categories have consistent colors

Using Hashtags

  • Add hashtags when creating or editing events
  • Use multiple hashtags for better organization
  • Filter by hashtags to find related events
  • View aggregated stats across hashtag groups

🔧 Troubleshooting

Common Issues

Login Problems

  • Clear browser cookies and try again
  • Use the "Clear Session" page: /admin/clear-session
  • Contact your administrator for password reset

Data Not Syncing

  • Check your internet connection
  • Refresh the page to see latest updates
  • Ensure you're on the correct edit link

Charts Not Displaying

  • Try a different browser (Chrome, Firefox, Safari)
  • Disable browser extensions temporarily
  • Clear browser cache

Getting Help

  • Contact your event organizer or admin
  • Check the Projects page for event status
  • Report technical issues to your system administrator

MessMass Version 5.21.2
Last Updated: 2025-10-06

For additional help, contact your system administrator or refer to the GitHub repository.