# Introduction

Welcome to Fotify, the comprehensive event management and photo sharing platform that transforms how you capture and share memories. This guide will help you navigate the platform's features and make the most of your event experience.

## What is Fotify?

Fotify is an all-in-one event management solution that combines:

1. **Real-time Photo Sharing**: Allow guests to upload photos instantly to a live carousel and shared album
2. **RSVP Management**: Create custom invitations, track responses, and manage your guest list
3. **Attendance Tracking**: Verify guest attendance with QR code check-in
4. **Multilingual Support**: Engage with guests in their preferred language

Whether you're organizing a wedding, corporate event, birthday party, or any special occasion, Fotify provides the tools to create meaningful, interactive experiences.

## Table of Contents

1. [Introduction](/)
2. [Getting Started](/getting-started)
3. [Creating a New Event](/creating-a-new-event)
4. [Event Types and Features](/event-types-and-features)
5. [Credits System](/credits-system)
6. [Managing Events](/managing-events)
7. [Getting Upload URL and QR Code](/getting-upload-url-and-qr-code)
8. [Viewing and Reviewing the Album](/viewing-and-reviewing-the-album)
9. [Using the Live Carousel](/using-the-live-carousel)
10. [RSVP Management](/rsvp-management)
11. [Work in Progress Features](/work-in-progress-features)

## Key Features

### Photo Sharing and Display

* **Live Photo Carousel**: Display photos in real-time on a big screen during your event
* **Moderation Controls**: Approve photos before they appear (optional)
* **Guest Upload**: Easy web-based uploading without requiring an account or app
* **QR Code Access**: Provide quick upload access through scannable codes
* **Bulk Download**: Save all event photos in one convenient package

### RSVP and Guest Management

* **Custom Digital Invitations**: Create beautiful, personalized invitations
* **Response Tracking**: Monitor acceptances, declines, and pending responses
* **Guest List Management**: Add guests individually or through bulk upload
* **Messaging Templates**: Share invitations easily with personalized messages
* **Location Integration**: Include interactive maps and directions

### Event Management

* **Multiple Event Types**: Choose plans based on your specific needs
* **Flexible Event Status**: Control when your event is active
* **Event Settings**: Customize all aspects of your event experience
* **Photo Limits**: Options for different photo capacity needs
* **Guest Limits**: Scale guest management based on event size

### Internationalization

* **Multiple Languages**: Support for English, Spanish, and French
* **Language Detection**: Automatically detect guest preferences
* **Localized Interface**: Complete translations across the platform

## System Requirements

Fotify works on:

* Modern web browsers (Chrome, Firefox, Safari, Edge)
* Mobile devices through responsive web design
* No app installation required for guests

## Support and Feedback

If you need assistance or want to provide feedback:

* Email: <hello@fotify.app>

Thank you for choosing Fotify to make your events more engaging and memorable!


# Getting Started

This guide will walk you through the initial steps to set up your account and create your first event.

## Creating Your Account

1. Visit the Fotify dashboard at [dashboard.fotify.app](https://dashboard.fotify.app)
2. You have two options to sign in:
   * **Google Authentication**: Click "Sign in with Google" and follow the prompts
   * **Magic Link**: Enter your email address and click "Sign in with Magic Link"
     * Check your email for a secure login link
     * Click the link to be automatically logged in

There's no password to remember, making login secure and convenient.

## Dashboard Overview

After logging in, you'll see your dashboard with these main sections:

1. **Sidebar Navigation**:
   * Home: Dashboard overview and event metrics
   * Events: Manage all your events
   * Photos: Access albums and uploads
   * RSVP: Manage invitations and guests
2. **Header Area**:
   * User menu (top right)
   * Credit balance display
   * Language selector
3. **Main Dashboard**:
   * Event metrics (live, upcoming, and past events)
   * Quick actions
   * Recent activity

## Checking Your Credit Balance

Before creating events, check your available credits:

1. Look at the credit indicator in the header
2. If this is your first time, you may have welcome credits
3. If you need to purchase credits:
   * Click on your credit balance or "Buy Credits"
   * Select a package that meets your needs
   * Complete the checkout process

## Creating Your First Event

To create a new event:

1. Click "Events" in the sidebar
2. Click the "New Event" button
3. Choose an event type based on your needs:
   * Each type has different features and credit costs
   * Review the comparison chart carefully
   * Free plan available for trying the platform
4. Fill in your event details:
   * Name (max 25 characters)
   * Description (max 150 characters)
   * Event photo (optional but recommended)
   * Location
   * Date and time
   * Photo approval settings
5. Click "Create Event"

Your event will be created in "Upcoming" status.

## Understanding Event Status

Events move through different statuses:

1. **Upcoming**: Initial status after creation
   * Can be edited but not used for photo collection
   * Preparations and settings can be configured
2. **Live**: Active event accepting photos
   * Start your event when ready to collect photos
   * Guests can upload and view the carousel
3. **Paused**: Temporarily suspended
   * Use when you need to temporarily stop photo collection
   * Can be resumed when needed
4. **Finished**: Completed event
   * Photos remain accessible but no new uploads
   * Download options available

## Setting Up Photo Collection

Once your event is created:

1. Start the event when ready (changes status to "Live")
2. Get the photo upload link or QR code:
   * Click on the QR code icon on your event
   * A modal will display with sharing options
3. Share with guests through:
   * Printed QR codes at the venue
   * Digital invitations
   * Direct messages
   * Social media

## Quick Tips for Success

1. **Test Before Your Event**:
   * Upload a few test photos
   * Check the carousel display
   * Scan the QR code from different devices
2. **Communicate Clearly**:
   * Let guests know how to access the upload page
   * Set expectations about photo approval
   * Encourage participation
3. **Monitor During the Event**:
   * Check for photos needing approval
   * Ensure the carousel is running smoothly
   * Address any issues promptly
4. **Post-Event Management**:
   * Download photos for safekeeping
   * Share the album with participants
   * Stop the event when finished


# Creating a New Event

Creating an event in Fotify has been enhanced with event types and credit system integration. Follow these steps to create your new event:

## Selecting an Event Type

1. Log in to your Fotify dashboard
2. Navigate to the "Events" page by clicking on the "Events" link in the sidebar
3. Click the "New Event" button at the top of the page
4. You'll see the event type selection screen with multiple options:
   * **Free Plan**: For trying the platform or small gatherings (0 credits)
   * **Basic Plan**: For small events with standard features (80 credits)
   * **Celebration Plan**: For medium events with advanced features (120 credits)
   * **Premium Plan**: For large events with all features (200 credits)
5. Compare the features of each plan:
   * Maximum photos allowed
   * Event duration
   * Gallery access period
   * RSVP management capabilities
   * Available features (bulk download, moderation, etc.)
6. Select the plan that best meets your needs

## Credit Validation

After selecting an event type:

1. The system checks if you have sufficient credits
2. If you have enough credits, you proceed to the event details form
3. If you don't have enough credits:
   * An "Insufficient Credits" modal appears
   * You'll see options to purchase the required credits
   * You can choose a suggested package or view all options
   * After purchasing, you'll be returned to continue event creation

## Filling the Event Details

Once you've selected an event type and have sufficient credits:

1. Enter event information:
   * **Event Name** (max 25 characters)
   * **Description** (max 150 characters)
   * **Location** (max 40 characters)
   * **Event Date and Time**
2. Upload an event photo (optional):
   * Click the upload area or drag and drop an image
   * Supported formats: JPG, PNG, GIF
   * Maximum size: 5MB
   * Images will be automatically optimized
3. Configure event settings:
   * **Photo Approval**: Choose whether to approve photos automatically or manually
4. Click "Create Event"

## After Creation

When your event is created:

1. Credits are deducted from your balance
2. The event is created in "Upcoming" status
3. You're redirected to the Events page
4. You can now:
   * Edit event details (before starting)
   * Configure RSVP settings (if available in your plan)
   * Prepare for starting the event

## Event Status Flow

After creation, your event follows this status progression:

1. **Upcoming**: Initial status after creation
2. **Live**: When you start the event (photos can be uploaded)
3. **Paused**: If you temporarily suspend the event
4. **Finished**: When the event is complete

## Tips for Successful Event Creation

* **Choose the right event type**: Consider your expected number of guests, photo needs, and feature requirements
* **Plan ahead**: Check duration limits to ensure they align with your event schedule
* **Prepare your event photo**: A high-quality image makes your event more engaging
* **Consider moderation needs**: For public events, manual approval may be preferable
* **Set clear expectations**: Be aware of the limitations of your chosen event type

## Event Creation Limitations

* You cannot change an event's type after creation
* Event duration is limited based on your chosen event type
* Maximum photos and guests are enforced based on the event type
* Some features are only available in specific event types


# Event Types and Features

Fotify offers different event types to match various needs and budgets. Each event type comes with a specific set of features and limitations. This guide helps you understand the differences to choose the right option for your event.

## Feature Explanations

### Max Photos

The maximum number of photos that can be uploaded to your event. After reaching this limit, no new photos can be uploaded unless you upgrade.

### Event Duration

The number of days your event can remain in "Live" status. After this period, you'll need to stop the event or upgrade.

### Gallery Access

The period after event completion during which the photo gallery remains accessible. After this period, access is restricted.

### Bulk Download

The ability to download all event photos as a single ZIP file. This feature is particularly useful for preserving memories after the event.

### Photo Moderation

Controls for approving photos before they appear in the live carousel and gallery. Without this feature, all photos are automatically approved.

### Max Guests

The maximum number of invitations you can create for RSVP management.

### RSVP Management

The ability to send invitations, track responses, and manage your guest list.

### Guest Upload During RSVP

Allows guests to upload photos when responding to their RSVP invitation.

### Attendance Tracking

QR code-based system for checking in guests at the event entrance.

## Feature Enforcement

Fotify automatically enforces the limitations of each event type:

1. **Photo Limits**: Upon reaching the limit, uploads will be disabled.
2. **Duration Limits**: The system tracks the number of days an event has been live and will notify you when approaching the limit.
3. **Gallery Access**: After the specified period, the gallery becomes inaccessible.
4. **Guest Limits**: Upon reaching the limit, new guest creation will be disabled.

## Tips for Choosing the Right Event Type

Consider these factors when selecting an event type:

1. **Event Size**: Estimate the number of guests and potential photo uploads
2. **Duration**: Determine how long the event will run
3. **Photo Sharing Needs**: Consider if you need moderation or bulk download
4. **RSVP Requirements**: Evaluate if you need guest management features
5. **Budget**: Balance features against credit costs


# Credits System

Fotify operates on a credit-based system that allows you to create events with different feature sets. This guide explains how credits work, how to purchase them, and how they're used within the platform.

## Understanding Credits

Credits are the currency used within Fotify to create events of various types. Each event type requires a specific number of credits to create.

### Credit Balance

Your current credit balance is displayed:

* On the event creation page

## Event Types and Credit Costs

Different event types offer various features and require different amounts of credits:

| Plan         | Credit Cost | Best For                              |
| ------------ | ----------- | ------------------------------------- |
| Free         | 0           | Trying the platform, small gatherings |
| Basic        | 80          | Small events, basic features          |
| Premium      | 120         | Medium events, comprehensive features |
| Professional | 200         | Large events, all features            |

## Purchasing Credits

To purchase credits:

1. Click on your credit balance or the "Buy Credits" button
2. In the purchase modal, you'll see available credit packages
3. Each package includes:
   * Number of credits
   * Price
   * Any special offers or labels (like "Best Value")
4. Select your desired package
5. Complete the payment process using a secure checkout
6. Credits will be added to your account immediately

## Using Credits

Credits are consumed when:

1. Creating a new event
2. The credit cost is based on the event type selected
3. Credits are deducted immediately upon event creation

### Credit Validation

Before creating an event, the system validates:

1. If you have sufficient credits for the selected event type
2. If not, you'll be prompted to purchase more credits
3. The system suggests appropriate credit packages based on what you need

## Insufficient Credits Flow

When you try to create an event without enough credits:

1. The system shows an "Insufficient Credits" modal
2. It displays:
   * Your current balance
   * The cost of the selected event type
   * The shortfall amount
   * Recommended credit package
3. You can choose to:
   * Purchase the suggested package
   * View more packages
   * Cancel and select a different event type

## Credit Transaction History

To view your credit history:

1. Access your profile settings
2. Navigate to the "Billing" section
3. View a detailed transaction history

## Credit Policies

Important policies regarding credits:

1. **No Expiration**: Credits do not expire once purchased
2. **Non-Transferable**: Credits cannot be transferred between accounts
3. **Refunds**: Refund policies are governed by the terms of service
4. **Pricing Changes**: Credit costs for event types may change, but purchased credits remain valid

## Billing Portal

Fotify integrates with a secure billing portal that allows you to:

1. View all past transactions
2. Download receipts and invoices
3. Update payment methods
4. Manage subscriptions (if applicable)

To access the portal:

1. Click on your profile/account menu
2. Select "Billing Portal"
3. You'll be redirected to a secure management interface

## Credit Usage Tips

* Purchase larger credit packages for better value
* Plan your event needs in advance to optimize credit usage
* Check feature requirements carefully before selecting event types
* Monitor your credit balance regularly


# Managing Events

Fotify allows you to manage your events through different statuses and provides various tools to control your event experience. This guide covers all aspects of event management.

## Event Statuses

Events in Fotify move through four key statuses:

### 1. Upcoming

New events start in this status.

* **Characteristics**:
  * Event details can be edited
  * RSVP setup can be configured (if available in your plan)
  * Photo uploads are not yet enabled
  * Event countdown is visible

### 2. Live

The event is currently active and accepting photo uploads.

* **Characteristics**:
  * Photo uploads are enabled
  * Live carousel is available
  * RSVP responses are accepted (if enabled)
  * Limited editing of event details

### 3. Paused

The event is temporarily paused but can be resumed.

* **Characteristics**:
  * Photo uploads are temporarily disabled
  * Live carousel remains accessible but doesn't update
  * RSVP system is paused
  * Can be resumed to Live status

### 4. Finished

The event has ended and no longer accepts new photos.

* **Characteristics**:
  * Photo uploads are permanently disabled
  * Gallery remains accessible for the period specified in your event type
  * Final statistics are available
  * Bulk download available (if included in event type)

## Managing Event Status

### From Upcoming to Live

1. Go to the "Events" page in your dashboard
2. Find your Upcoming event
3. Click the "Start" button
4. Confirm when prompted
5. Your event status changes to Live, and guests can begin uploading photos

### From Live to Paused

1. From the Events page, find your Live event
2. Click the "Pause" button
3. Confirm when prompted
4. Your event is now temporarily paused

### From Paused to Live

1. From the Events page, find your Paused event
2. Click the "Resume" button
3. Confirm when prompted
4. Your event returns to Live status

### From Live or Paused to Finished

1. From the Events page, find your Live or Paused event
2. Click the "Stop" button
3. Review the confirmation message carefully - this action cannot be undone
4. Confirm to permanently end the event
5. Your event changes to Finished status

## Event Dashboard and Actions

From the Events page, you can access various actions through the event card or dropdown menu:

### For All Events

* **View Details**: See complete event information
* **Edit** (Upcoming events only): Modify event settings

### For Live Events

* **Live Photos**: Access the real-time photo carousel
* **Album**: View all approved photos
* **QR Code**: Get the upload QR code to share
* **RSVP**: Manage invitations and guests (if available)

### For Finished Events

* **Album**: Access the complete photo collection
* **Download**: Get all photos as a ZIP file (if available)
* **Live Photos**: View the carousel (read-only)
* **RSVP Stats**: View final attendance figures

## Editing Event Details

For Upcoming events:

1. Click the "Edit" button or pencil icon
2. You can modify:
   * Event name
   * Description
   * Event photo
   * Location
   * Date and time
   * Photo approval settings
3. Save your changes

## Gallery Access Period

After an event is finished:

1. The photo gallery remains accessible based on your event type
2. You'll see a countdown indicating remaining gallery access days
3. You can still download photos during this period
4. After the access period expires, the gallery becomes inaccessible

## Deleting an Event

You can only delete Upcoming events:

1. Go to the event's edit page
2. Scroll to the bottom
3. Click "Delete Event"
4. Confirm the deletion
5. This action cannot be undone and credits will not be refunded

## Event Metrics

The Events page provides several metrics:

1. Total number of events by status
2. Photo counts for each event
3. Guest/RSVP statistics
4. Duration tracking for Live events

## Event Sorting and Filtering

From the Events page, you can:

1. Switch between "Current & Upcoming" and "Past Events" tabs
2. Search for specific events
3. Sort events by various criteria
4. Navigate through pagination for multiple events

## Best Practices

1. **Plan Your Timeline**: Be aware of duration limits for your event type
2. **Monitor Activity**: Check your Live events regularly
3. **Communicate Changes**: Let guests know if you pause or stop an event
4. **Download Before Expiry**: Ensure you download photos before gallery access expires
5. **Consider Upgrades**: If you need more time or features, explore upgrading


# Getting Upload URL and QR Code

Enabling guests to upload photos is a key part of the Fotify experience. This guide covers how to generate, share, and manage upload links and QR codes.

## Accessing the Upload Options

You can get the upload URL and QR code in several ways:

1. **From the Event Card**:
   * Locate your event on the Events page
   * Look for the QR code icon in the action buttons
   * Click the icon to open the sharing modal
2. **From the Event Dropdown**:
   * Click the "More" or three-dot menu on an event
   * Select "QR Code" from the dropdown options
3. **From the Photos Page**:
   * Navigate to the Photos section
   * Find your event
   * Click the QR code icon

## The QR Code Modal

When you open the QR code sharing modal, you'll see:

1. **QR Code Display**: A large, clear QR code optimized for scanning
2. **Upload URL**: The direct link that guests can use
3. **Sharing Options**:
   * Copy Link: Copies the URL to your clipboard
   * Print QR Code: Opens a printer-friendly page
   * Download QR Code: Saves the QR image for digital sharing

## Sharing the QR Code

### At Physical Events

1. **Print and Display**:
   * Use the print option to create high-quality printouts
   * Place QR codes at:
     * Entry points
     * Table centerpieces
     * Near photo booths
     * On event programs
   * Include brief instructions: "Scan to upload your photos!"
2. **Digital Displays**:
   * Show the QR code on screens throughout the venue
   * Include it in slideshow presentations
   * Display periodically on the live carousel (happens automatically)

### For Virtual/Hybrid Events

1. **Digital Sharing**:
   * Download the QR code image
   * Share in digital invitations
   * Include in email communications
   * Post on event websites or social media
   * Share in messaging apps
2. **Direct Link Sharing**:
   * Copy the upload URL
   * Share via email, text, or messaging apps
   * Include in digital event materials

## Guest Experience

When guests access the upload URL or scan the QR code:

1. They'll see a mobile-friendly upload page
2. They can select photos from their device
3. Add an optional name (author)
4. Include an optional message
5. Submit the photo
6. Receive confirmation of successful upload

## QR Code Features

Fotify's QR codes include:

1. **High Contrast**: Easy to scan in various lighting conditions
2. **Error Correction**: Works even if partially obscured or damaged
3. **Embedded Event Info**: Opens directly to the correct event
4. **Language Detection**: Attempts to match guest language preferences
5. **Automatic Display**: Periodically shows on the live carousel

## Managing Upload Access

Upload access is controlled by your event status:

1. **Upcoming**: Upload URL is not active
2. **Live**: Full upload access enabled
3. **Paused**: Uploads temporarily disabled
4. **Finished**: Uploads permanently disabled

The QR code and URL remain the same throughout the event's lifecycle, but their functionality changes based on status.

## URL/QR Code Security

The upload URL includes:

1. A unique identifier for your event
2. Security validations to prevent unauthorized use
3. Status checking to enforce event rules
4. Secure transmission of photos

## Testing Before Your Event

Always test your QR code before the event:

1. Scan with different devices
2. Try different lighting conditions
3. Verify the upload process works
4. Check that photos appear in your moderation queue or live carousel

## Monitoring Usage

During your event, you can monitor upload activity:

1. Check the photo count in your event dashboard
2. Review the moderation queue (if enabled)
3. Watch the live carousel for new content

## Photo Upload Limitations

Be aware of these limitations based on event type:

| Event Type  | Maximum Photos | Auto-Approval |
| ----------- | -------------- | ------------- |
| Free        | 50             | Optional      |
| Basic       | 200            | Optional      |
| Celebration | Unlimited      | Optional      |
| Premium     | Unlimited      | Optional      |

The system will display appropriate messages to guests when limits are reached.

## Best Practices

1. **Provide Context**: Include brief instructions with the QR code
2. **Test Thoroughly**: Scan the code with multiple devices before your event
3. **Have Backup Options**: Share both QR code and direct URL
4. **Consider Visibility**: Ensure QR codes are large enough and well-lit
5. **Monitor Activity**: Check uploads periodically during your event


# Viewing and Reviewing the Album

Fotify provides comprehensive tools for viewing, managing, and moderating your event photos. This guide explains how to make the most of the album features.

## Accessing the Album

There are multiple ways to access your event's photo album:

1. **From the Events Page**:
   * Find your event in the list
   * Click the "Album" button or select "Album" from the dropdown menu
2. **From the Photos Page**:
   * Navigate to the "Photos" section in the sidebar
   * Find your event in the list
   * Click on the event to view its album
3. **After Moderation**:
   * When reviewing photos, you can switch to the main album view

## Album Interface Overview

The album page consists of:

1. **Tab Navigation**:
   * **Approved Photos**: All approved and publicly visible photos
   * **Photos to Review**: Photos awaiting moderation (if moderation is enabled)
2. **Control Bar**:
   * Sorting options (date, author, message)
   * Search functionality
   * View controls
3. **Photo Grid**:
   * Thumbnail display of all photos
   * Status indicators for approved/pending
   * Upload date and author information
4. **Statistics Panel**:
   * Total photos uploaded
   * Photos remaining (based on plan limits)
   * Approved vs. pending counts

## Viewing Photos

To view a photo in detail:

1. Click on any photo in the grid
2. The photo opens in a modal view showing:
   * Full-size image
   * Author name
   * Message/caption
   * Upload date and time
   * Approval status

## Reviewing and Moderating Photos

If you've enabled manual approval

1. Switch to the "Photos to Review" tab
2. For each photo, you can:
   * **Approve**: Click the checkmark icon to make the photo visible
   * **Delete**: Click the trash icon to remove inappropriate content
   * **View Details**: Click the photo to see full size and information

### Moderation Best Practices

1. **Regular Checks**: Review the queue frequently during events
2. **Clear Guidelines**: Establish what content is appropriate beforehand
3. **Quick Decisions**: Process photos promptly to maintain engagement
4. **Consistent Standards**: Apply the same criteria to all submissions

## Photo Management Actions

For all photos (approved or pending), you can:

1. **Delete**: Remove inappropriate or unwanted photos
2. **View Details**: See full information about the photo
3. **Download Individual Photos**: Save specific images locally

These actions are available from:

* The photo detail view
* Action buttons on photo thumbnails (hover to see)

## Album Sorting and Organization

Organize your album using these tools:

1. **Sort By**:
   * **Date (newest first)**: Default view showing recent uploads first
   * **Date (oldest first)**: Chronological view from beginning
   * **Author**: Alphabetical grouping by photographer name
   * **Message**: Organize by caption text
2. **Search**:
   * Filter photos by author name
   * Search within photo messages
   * Find photos from specific dates
3. **Pagination**:
   * Navigate through large collections
   * Adjust how many photos display per page

## Album Access Duration

After an event ends:

1. The album remains accessible based on your event type:
   * Free: 7 days
   * Basic: 30 days
   * Celebration: 90 days
   * Premium: 365 days
2. You'll see:
   * A countdown of remaining access days

## Bulk Download

For Celebration and Premium plans:

1. The "Download All" option appears for finished events
2. This creates a ZIP file containing all approved photos
3. See the dedicated "Bulk Download" guide for details

## Technical Specifications

* **Supported Photo Views**: Thumbnails, full-size, slideshow
* **Thumbnail Quality**: Optimized for fast loading
* **Full-size View**: Maximum quality within browser constraints
* **Mobile Optimization**: Responsive design for all devices
* **Loading Behavior**: Progressive loading for faster browsing

## Tips for Album Management

1. **Regular Moderation**: Check the review queue throughout your event
2. **Clear Communication**: Set expectations about approval times with guests
3. **Content Guidelines**: Consider sharing photo guidelines with participants
4. **Backup Plan**: Download photos before gallery access expires
5. **Engagement Strategy**: Encourage viewing the album during and after events


# Using the Live Carousel

The Live Carousel is one of Fotify's most engaging features, displaying photos in real-time during your event. This guide explains how to set up, customize, and share this dynamic display.

## Accessing the Carousel

You can access the Live Carousel in several ways:

1. **From the Events Page**:
   * Find your active event
   * Click the "Live" button or select "Live" from the dropdown menu
2. **From the Photos Page**:
   * Navigate to the "Photos" section
   * Find your event
   * Click the "Live" button

## Carousel Controls

The carousel interface includes:

1. **Speed Control**:
   * Default setting is 3 seconds
2. **Display Controls**:
   * Fullscreen toggle
   * Share button for public viewing
3. **Information Display**:
   * Author name
   * Photo message/caption
   * Periodic QR code for uploads

## Carousel Features

### Real-time Updates

The carousel automatically:

1. Fetches new approved photos at regular intervals
2. Adds them to the display rotation
3. Shows the most recent content first
4. Maintains smooth transitions between photos

### Matrix Background

The dynamic background displays:

1. Miniature versions of event photos
2. Animated movement for visual interest
3. Low-opacity overlay that doesn't distract from main photos
4. Automatic color matching with main images

### QR Code Display

The system periodically shows:

1. A prominent QR code for easy uploads
2. Brief instructions for guests
3. Automatic timing based on event activity
4. Smart positioning that doesn't interfere with photos

## Setting Up for Display

For optimal viewing experience:

1. **Hardware Recommendations**:
   * Large screen TV or projector
   * Stable internet connection (wired if possible)
   * Dedicated computer or tablet
   * Proper viewing angle for all guests
2. **Browser Setup**:
   * Use Chrome, Firefox, Safari, or Edge
   * Enable fullscreen mode (F11 or fullscreen button)
   * Test performance before the event
   * Consider disabling sleep/screensaver settings

## Public Sharing

To share the carousel with remote viewers:

1. Click the Share button in the carousel controls
2. In the sharing modal:
   * Copy the generated public link
   * Optionally generate a new link (invalidates previous links)
   * Share via your preferred method

The public link:

* Doesn't require login
* Updates in real-time
* Works on mobile and desktop devices
* Expires when the event ends

## Carousel Behavior

The carousel handles different scenarios intelligently:

1. **No Photos Yet**:
   * Displays welcome message
   * Shows prominent QR code
   * Provides upload instructions
   * Updates immediately when photos arrive
2. **Few Photos**:
   * Cycles through available images
   * Displays each photo longer
   * Shows QR code more frequently
   * Transitions smoothly between limited content
3. **Many Photos**:
   * Prioritizes recent uploads
   * Cycles through all approved content
   * Balances showing variety and new submissions
   * Optimizes loading for performance

## Best Practices

1. **Test Before the Event**:
   * Upload test photos
   * Check display on actual equipment
   * Verify internet connectivity
   * Confirm QR code is scannable from viewing distance
2. **Optimize Speed Settings**:
   * Smaller events: 4-5 seconds per photo
   * Larger events: 2-3 seconds per photo
   * Adjust based on upload frequency
   * Consider audience engagement
3. **Encourage Participation**:
   * Announce the carousel to guests
   * Point out the QR code when it appears
   * Highlight interesting photos periodically
   * Create photo challenges or themes
4. **Technical Management**:
   * Monitor internet connectivity
   * Have backup display options
   * Check moderation queue regularly
   * Restart browser if performance decreases

## Troubleshooting

Common issues and solutions:

1. **Carousel Not Updating**:
   * Check internet connection
   * Verify event is still in "Live" status
   * Confirm photos are being approved
   * Refresh the browser
2. **Performance Issues**:
   * Reduce transition speed
   * Close other browser tabs
   * Restart the browser
   * Check system resources
3. **Display Problems**:
   * Adjust screen resolution
   * Try different browsers
   * Check fullscreen mode
   * Verify compatible hardware
4. **QR Code Not Appearing**:
   * Wait longer (appears periodically)
   * Refresh the carousel
   * Check that uploads are enabled
   * Verify event status is "Live"


# Bulk Download

Fotify lets you download every photo and video from an event in a single ZIP package. This guide covers how to use this functionality.

## Availability

Bulk download is available on **every paid plan**, regardless of the event's current status (upcoming, live, paused, or finished). The only restrictions are:

* **Free plan**: free events do not include bulk download.
* **Expired gallery access**: once your gallery access window closes, the download is no longer available.

Each paid tier ships with its own gallery access duration (Photo Gallery: 90 days, Premium Event: 365 days after event end). Within that window the download button is always enabled for paid events — organizers commonly use it mid-event to share batches with photographers or social teams.

## How to Download All Photos

1. **Access the Download Option**:
   * From the Photos page in the dashboard, click the "Download All" action — available at any point during a paid event
   * The button is always visible, but disabled on free plans or expired galleries
2. **First-Time Download Process**:
   * If this is the first time downloading, the system will prepare a ZIP file
   * For large collections, you'll receive a notification that preparation is in progress
   * You will receive an email when the download is ready
   * The system displays "Processing" status during preparation
3. **Subsequent Downloads**:
   * If the ZIP file was previously generated, it will be available immediately
   * Click to download the pre-generated ZIP file

## Download States

The download button displays different states:

* **Processing**: System is preparing your ZIP file
* **Ready**: ZIP file is prepared and ready to download
* **Download**: Click to start downloading the prepared ZIP file
* **Failed**: There was an issue creating the ZIP file (try again)

## ZIP File Contents

The downloaded ZIP package contains:

1. All approved event photos in their original quality
2. Organized folder structure based on upload dates
3. Original filenames when available
4. Photo metadata including author and message information

## Technical Considerations

* **File Size**: ZIP files can be large depending on the number and size of photos
* **Download Time**: Depends on your internet connection speed
* **Browser Support**: Works in all modern browsers
* **Mobile Devices**: May require sufficient storage space

## Download Expiration

The download link remains valid:

* For the duration of your event type's gallery access period
* Celebration Plan: 90 days after event end
* Premium Plan: 365 days after event end

## Troubleshooting Download Issues

If you encounter problems:

1. **Download Not Starting**:
   * Check your browser's download settings
   * Try a different browser
   * Ensure you have sufficient disk space
2. **Preparation Taking Too Long**:
   * For very large collections (1000+ photos), preparation may take several hours
   * Check your email for completion notification
   * Contact support if preparation exceeds 24 hours
3. **Failed Status**:
   * Click "Try Again" to restart the preparation process
   * If the issue persists, contact support

## Sharing the Photo Collection

After downloading, you might want to:

1. Create a backup copy on external storage
2. Share with a professional photographer for editing
3. Create custom photo books or prints
4. Share with event participants via cloud storage


# RSVP Management

Fotify's RSVP management system allows you to create and manage invitations, track responses, and monitor attendance for your events. This guide covers all aspects of the RSVP functionality.

## Creating an Invitation

To set up RSVP for an event:

1. Navigate to the "Events" page
2. Click on "RSVP" for your event
3. If no invitation exists, you'll be prompted to create one:
   * Set an RSVP deadline (must be before the event date)
   * Click "Create Invitation"

## RSVP Dashboard Overview

The RSVP dashboard consists of three main tabs:

* Event Details
* Invitation
* Guests

### Event Details Tab

This tab provides an overview of your RSVP system:

1. **RSVP Statistics**:
   * Confirmed invitations
   * Declined invitations
   * Total guests
   * Total confirmed guests
2. **RSVP Settings**:
   * RSVP Deadline: The date by which guests must respond
   * Invitation Status: Control whether the RSVP system is active, paused, or finished

> **Note**: The RSVP system is automatically paused when an event is not live.

## Customizing the Invitation

The "Invitation" tab allows you to personalize the RSVP experience:

### Personalization Guide

The system uses template keys to customize messages:

* `{{FIRSTNAME}}`: Inserts the guest's first name
* `{{LASTNAME}}`: Inserts the guest's last name
* `{{FULLNAME}}`: Inserts the guest's full name
* `{{RSVP_LINK}}`: Inserts the personalized RSVP link (required)

### Hero Image

1. Upload a feature image for your invitation
2. Use the cropping tool to adjust how the image appears on mobile devices
3. Remove or replace the image as needed

### Invitation Content

Use the rich text editor to create beautiful invitations:

* Formatting options (bold, italic, underline)
* Text alignment
* Color and highlighting
* Bulleted and numbered lists
* Links and images
* HTML widgets for advanced users

### Message Template

Create a template for sharing invitations:

1. Write a message that will be sent to guests
2. Include the `{{RSVP_LINK}}` placeholder
3. Personalize with name placeholders

Example:

```
Dear {{FIRSTNAME}},

You're invited to our special event!

Please RSVP using this link: {{RSVP_LINK}}

We look forward to your response!
```

### Location Settings

Add location details to your invitation:

1. Search for a location using the Google Maps integration
2. The selected location will appear on the invitation with an interactive map
3. Add optional location instructions for parking, entrance details, etc.

### Attendance Settings

Configure how attendance will be tracked:

1. Enable QR Code Access to generate unique QR codes for each guest
2. Set a security password for staff members who will check guests in
3. Access the attendance verification page link to share with staff

## Managing Guests

The "Guests" tab provides tools to manage your guest list:

### Adding Guests

Add guests individually:

1. Click "Add Guest"
2. Enter guest details:
   * Name (required)
   * Last Name
   * Email (optional)
   * Cellphone (optional)
   * Number of Guests allowed (the maximum plus-ones they can bring)
3. Click "Add Guest"

### Bulk Upload

Upload multiple guests at once:

1. Click "Upload Guest List"
2. Prepare a CSV file with columns: Name, LastName, Email, Phone, Guests
3. Upload the file
4. Review the upload results

### Guest Management

For each guest, you can:

1. View their details and RSVP status
2. Edit their information
3. Delete their invitation
4. Copy their personalized invitation message
5. Send a WhatsApp message (if phone number is provided)

### Guest List Features

* Search functionality to find specific guests
* Sort by name, email, phone, or status
* Track which guests have received WhatsApp messages
* Reset WhatsApp tracking as needed
* Download the complete guest list as CSV

## RSVP Process for Guests

When a guest receives their invitation:

1. They click on their personalized RSVP link
2. They view the event details and invitation content
3. They can respond:
   * Accept with pleasure
   * Decline with regret
4. If accepting, they specify:
   * Number of guests attending (limited by the maximum you set)
   * Additional comments (dietary restrictions, etc.)
5. If you've enabled it, they can upload photos during the RSVP process
6. After responding, they receive a confirmation

## Attendance Verification

For in-person events, you can track attendance:

### Setting Up Attendance Tracking

1. Enable QR Code Access in the Attendance Settings
2. Set a security password for staff members
3. Share the attendance verification link with event staff

### Check-in Process

1. Staff opens the attendance verification page
2. They enter the security password
3. They scan guest QR codes or search for guests manually
4. The system displays guest information and status
5. Staff marks guests as attended
6. The system tracks attendance history

### QR Codes for Guests

When a guest accepts an invitation:

1. They receive a personal QR code in their confirmation
2. They show this code at the event entrance
3. Staff scans or manually checks them in
4. The system updates their status from "Accepted" to "Attended"

## RSVP Limits and Features

Features vary by event type:

* Maximum number of guests/invitations
* Custom invitation designs
* Attendance tracking capabilities

> **Note**: If you reach your guest limit, you'll need to upgrade your event type or purchase additional credits.


# Work in Progress Features

Fotify is constantly evolving to provide the best experience for event organizers and guests. Here are some features currently in development:

1. **AI Content Moderation**: We're working on implementing AI capabilities to automatically detect and filter out inappropriate content, ensuring a safe and positive environment for all users.
2. **Photographer API**: We're developing an API that will allow photographers and event organizers to upload photos more easily and integrate Fotify seamlessly into their workflows.
3. **Custom Branding**: For our partnership program, we're working on features like custom labeling, custom domains, and advanced customization options to tailor Fotify to your brand.
4. **Enhanced Analytics**: We're building robust analytics tools to provide insights into guest engagement, popular photos, and other valuable metrics for event organizers.

Stay tuned for updates on these exciting new features!