Calendar & Events
Mosic includes a powerful calendar system for scheduling events, managing your time, and seamlessly integrating with Google Calendar. Events can be linked to tasks and appear on timeline views throughout the application, helping you stay organized and productive.
Calendar Timeline View
The calendar provides an intuitive timeline view that displays your schedule across multiple days with hourly precision.
Accessing the Calendar
The calendar timeline appears in multiple locations throughout Mosic:
- Today page - Right panel shows the timeline with your daily schedule
- Calendar page - Dedicated full calendar view with advanced features
- Upcoming page - Timeline view focusing on future events
Timeline Features
The timeline view provides comprehensive scheduling visibility:
- Date headers - Displays multiple days simultaneously (e.g., Tuesday 7, Wednesday 8, Thursday 9)
- Time grid - Hourly slots displayed vertically (typically 08:00 to 18:00, expandable)
- All-day row - Special row at the top for all-day events
- Event blocks - Color-coded blocks positioned on the timeline
- Current day highlight - Visual indicator showing today’s date
- Scrollable view - Horizontal scroll for more days, vertical scroll for different times
Event Blocks
Events appear as colored blocks on the timeline, providing at-a-glance information:
- Event title - Displayed prominently on the event block
- Time and duration - Shows time range and duration (e.g., “09:00 - 10:00 · 1h”)
- Color coding - Different colors for different calendars or categories
- Visual positioning - Blocks positioned precisely based on start time and duration
- Overlap handling - Multiple events at the same time are displayed side-by-side
Creating Events
Mosic offers flexible event creation options to match your workflow, from quick scheduling to detailed event planning.
Quick Event Creation
For rapid scheduling, use the streamlined quick create modal:
- Click the ”+ Create” button in the calendar view (blue button in top right)
- Enter the event title (required field)
- Set date and time using the smart date/time bar
- Optionally add a description
- Click Create Event to save
Quick create is ideal for:
- Simple meetings and appointments
- Quick task deadlines
- Placeholder events you’ll detail later
- Rapid schedule blocking
Full Event Creation
For events requiring detailed information, use the full creation mode:
- Click ”+ Create” and select Full mode (if prompted)
- Fill in comprehensive event details (see Event Fields below)
- Configure advanced options using the tabs
- Invite attendees and set reminders
- Link to related tasks or documents
- Save the complete event
Event Detail View
The event detail modal provides comprehensive access to all event properties and settings. Click any event block to open this view.
Event Header
The header displays key information and actions:
- “Edit Event” title (or “Create Event” for new events)
- Organizer indicator - “You are the organizer” badge when applicable
- Action buttons:
- Save - Blue button to save changes
- Copy - Duplicate the event
- Delete - Trash icon to remove the event
- Close - X button to exit without saving
Event Fields
Subject (Required)
- Event title input field with edit icon
- Maximum 200 characters
- Displayed on timeline blocks and lists
- Examples: “Team Meeting”, “Client Presentation”, “Project Deadline”
Date and Time (Required)
The smart date/time bar provides intuitive scheduling:
- Quick summary display (e.g., “Today 10 All 1hr”)
- Start date/time picker with calendar icon
- End date/time picker
- Duration automatically calculated and displayed
- All-day toggle - Checkbox to make event span entire day(s)
- All-day events appear in the special all-day row
- No specific times displayed for all-day events
Time validation:
- End time must be after start time
- Maximum 24-hour duration for single events
- Supports multi-day events when using all-day mode
Calendar Selection
Choose which calendar to associate with the event:
- Calendar dropdown showing available calendars
- Google Calendar indicator - “(Google)” label for synced calendars
- Multiple calendar support - Work, Personal, Project-specific, etc.
- Smart defaults - Automatically selects workspace default calendar
- Sync status indicators:
- “Synced” - Successfully synchronized
- “Pending” - Queued for synchronization
- “Sync failed” - Red indicator with error
- “Retry” button - Manually retry failed synchronization
Location (Optional)
- Text input for event location
- Supports various location types:
- Physical addresses (e.g., “Conference Room A”, “123 Main St”)
- Video call links (e.g., Google Meet, Zoom URLs)
- Building or room names
- Virtual meeting platforms
Description (Optional)
- Multi-line text editor
- Provide event details, agendas, or context
- Supports formatted text
- Automatically converts from rich text to plain text when needed
Guest Invitations (Optional)
Invite attendees to your events:
- “Add guests by email…” input field
- Enter comma-separated email addresses
- Email validation - Ensures valid email format
- Maximum 100 guests per event
- Guest response tracking - See who accepted, declined, or is tentative
- Attendee list - Displays invited guests and their response status
For invited guests:
- RSVP buttons - Accept, Maybe, Decline options
- Current response status displayed with color coding
- Read-only notice - Attendees can view but not edit event details
- Organizer information - Shows who invited you
Tab Navigation
The event modal organizes features into four tabs:
1. Details Tab (Default)
Contains all primary event information:
- Event title
- Date and time settings
- Calendar selection
- Location
- Description
- Guest invitations
- Tags (for existing events)
2. Advanced Tab
Additional event configuration:
- Reminder settings - Choose reminder timing (5, 10, 15, 30 minutes, 1 hour, 2 hours, 1 day, or none)
- Event status - Confirmed, Tentative, Cancelled, or Needs Action
- Free/Busy indicator - Free, Busy, Tentative, or Out of Office
- Privacy level - Private, Public, or Confidential
- Google Calendar sync - Enable/disable synchronization toggle
- Video conferencing - Add Google Meet link (when synced with Google Calendar)
- Sync status display - Current synchronization state with retry option
3. Repeat Tab
Configure recurring events:
- Repeat toggle - Enable recurring event pattern
- Frequency options:
- Daily - Every day
- Weekly - Specific days of the week
- Monthly - Same date each month
- Yearly - Annual recurrence
- Weekly day selection - Choose Mon, Tue, Wed, Thu, Fri, Sat, Sun
- End date (optional) - “Until” date picker (leave blank to repeat indefinitely)
Repeat validation:
- Frequency must be selected when repeat is enabled
- Weekly recurrence requires at least one day selected
4. Relations Tab
Link events to other documents:
- Task relations - Connect events to related tasks
- Document links - Associate with projects, spaces, or other documents
- Bi-directional linking - Relations visible from both sides
- Relation types - Related, Blocks, Blocked By, etc.
Use cases:
- Link planning meetings to project tasks
- Connect deadlines to deliverables
- Associate sprint events with sprint tasks
Google Calendar Integration
Mosic provides powerful Google Calendar integration with automatic two-way synchronization, allowing you to manage events across both platforms seamlessly.
Setting Up Google Calendar
To connect your Google Calendar account:
- Navigate to Settings → Calendar
- Click “Authorize Google Calendar Access”
- Sign in to your Google account
- Grant calendar permissions to Mosic
- Select which Google calendars to sync
- Set your default calendar for new events
- Configure sync preferences (pull from Google, push to Google)
Account settings:
- Account name - Friendly name for this Google account
- Primary account - Set as your default Google Calendar
- Workspace assignment - Link account to a specific workspace
- Enable/disable - Toggle synchronization on/off
- Connection status - Connected, Disconnected, Failed, Expired, or Pending Authorization
Two-Way Synchronization
Mosic supports bidirectional sync with Google Calendar:
From Google to Mosic (Pull):
- Events created in Google Calendar automatically appear in Mosic
- Updates made in Google Calendar sync to Mosic
- Deleted events in Google Calendar are removed from Mosic
- Guest invitations and responses sync to Mosic
From Mosic to Google (Push):
- Events created in Mosic sync to Google Calendar
- Changes made in Mosic update Google Calendar
- Deleted events in Mosic are removed from Google Calendar
- Guest lists and event details push to Google Calendar
Sync features:
- Async background processing - Non-blocking synchronization
- Intelligent queuing - Events queued for sync without UI delays
- Automatic retry - Failed syncs retry automatically
- Change detection - Only modified events are synced
- Conflict resolution - ETag-based change detection prevents overwrites
Sync Status
Monitor synchronization state for each event:
Status indicators:
- “Synced” - Green indicator, successfully synchronized
- “Pending” - Yellow indicator, queued for synchronization
- “Failed” - Red indicator, synchronization error occurred
- “Conflict” - Orange indicator, conflicting changes detected
- “Deleted” - Gray indicator, event deleted in Google Calendar
When sync fails:
- Check the sync error message in the event details
- Click the “Retry” button to attempt sync again
- Verify your Google Calendar connection in Settings
- Ensure you have calendar owner access (not just read access)
- Check internet connectivity
- Re-authorize Google Calendar access if needed
Sync information:
- Last sync time - When event was last synchronized
- Sync retry count - Number of retry attempts
- Sync error message - Detailed error description (if failed)
- Google Calendar event ID - Unique identifier in Google Calendar
Google Calendar Features
Supported Google Calendar features:
- Multiple calendars - Sync multiple Google accounts and calendars
- Google Meet integration - Automatically add video conferencing links
- Attendee management - Guest invitations sync both ways
- Calendar colors - Google Calendar colors preserved in Mosic
- Time zones - Intelligent timezone handling and conversion
- Recurring events - Recurrence patterns sync to Google Calendar
- Event reminders - Reminder settings synchronized
Calendar access roles:
- Owner - Full access, can create and edit events (required for event creation)
- Writer - Can create and edit events (required for event creation)
- Reader - View-only access (cannot create events in this calendar)
- Free/Busy Reader - Only see availability (limited access)
Note: You can only create or edit events in calendars where you have Owner or Writer access.
Moving Events Between Calendars
Change which calendar an event belongs to:
- Open the event in edit mode
- Select a different calendar from the Calendar dropdown
- Click Save
What happens:
- Event is deleted from the old Google Calendar
- Event is created in the new Google Calendar
- New Google Calendar event ID is assigned
- Organizer information updates to the new calendar’s email
- Sync status resets to “Pending”
Google Meet Integration
Add video conferencing to your events:
- Enable “Sync with Google Calendar” for the event
- Navigate to the Advanced tab
- Toggle “Add Video Conferencing” on
- Save the event
Result:
- Google Meet link automatically created
- Link stored in event’s
google_meet_linkfield - Link displayed in event details
- Link accessible to all invited guests
Configuration Options
Per-account settings:
- Pull from Google Calendar - Import Google events into Mosic
- Push to Google Calendar - Export Mosic events to Google
- Enable async sync - Use background job processing (recommended)
- Default calendar - Which Google calendar to use for new events
- Selected calendars - Which Google calendars to display in Mosic
Workspace calendar preferences:
- Default calendar ID - Workspace-specific default calendar
- Auto-sync - Automatically enable sync for new events
- Calendar usage tracking - Track calendar usage for smart defaults
Navigating the Calendar
Date Navigation
Navigate through your schedule with intuitive controls:
Navigation controls:
- Previous button (←) - Move to previous day(s)
- Next button (→) - Advance to next day(s)
- Date display - Shows current date range (e.g., “Tuesday 7 - Thursday 9”)
- Today button - Quickly return to current day
- Date picker - Jump to specific date
Multi-day view:
- Timeline displays multiple days simultaneously (typically 3-7 days)
- Horizontal scroll reveals additional dates
- Vertical scroll shows different time ranges
- Events span across the date grid
- Seamless scrolling between days
Time Navigation
Control the time range displayed:
- Vertical scroll - Navigate through different times of day
- Hourly grid - Default view shows 08:00 to 18:00
- Expandable range - Scroll to see earlier or later times
- Time increments - Hourly divisions with 30-minute visual guides
- All-day section - Always visible at top regardless of scroll position
Calendar Views
Timeline view (default):
- Horizontal multi-day layout
- Vertical hourly time slots
- Optimal for detailed schedule planning
- Best for seeing multiple days at once
Event Management
Editing Events
Modify existing events easily:
- Click the event block on the timeline
- Event detail modal opens automatically
- Edit any fields - Title, time, location, description, etc.
- Save changes - Click the blue “Save” button
- Event updates immediately on the timeline
Edit permissions:
- Organizers - Full editing access
- Workspace Admins/Editors - Can edit all workspace events
- Workspace Members - Can edit only their own events
- Invited attendees - View-only access (cannot edit)
Copying Events
Duplicate events to create similar entries quickly:
- Open the event you want to copy
- Click the Copy icon in the event header
- New event modal opens with duplicated information
- Modify details as needed
- Save to create the duplicate event
Use cases:
- Create recurring meetings manually
- Duplicate templates for similar events
- Copy event details to a different date
- Replicate event structure for multiple projects
Deleting Events
Remove events permanently:
- Open the event detail modal
- Click the trash icon in the header
- Confirm deletion (if prompted)
- Event removed from calendar and Google Calendar (if synced)
What happens:
- Event deleted from Mosic database
- Event removed from Google Calendar (if synced)
- Relations to tasks are removed
- Tags are unlinked
- Attendees no longer see the event
- Cannot be undone
Deletion permissions:
- Organizers can delete their events
- Workspace Admins/Editors can delete any workspace event
- Members can delete only their own events
Event Actions Summary
Available actions from event detail view:
- Save - Save changes to the event
- Copy - Duplicate the event with same details
- Delete - Permanently remove the event
- Close - Exit without saving changes
- RSVP - Accept/Decline/Maybe (for invited attendees)
- Retry Sync - Retry Google Calendar synchronization (if failed)
Time Zones
Mosic provides intelligent timezone handling to ensure events display correctly regardless of location.
Timezone Configuration
Events respect timezone settings at multiple levels:
- User timezone - Set in your profile (Settings → General)
- Event timezone - Stored with each event
- System timezone - Server default timezone
- Google Calendar timezone - Google account timezone
Timezone priority:
- Event’s specified timezone (if set)
- User’s profile timezone preference
- System timezone as fallback
Timezone Display
How timezones work:
- Events display in your configured timezone
- Times automatically convert based on your settings
- All-day events ignore timezone (represent calendar dates)
- UTC offset displayed in event details (e.g., “+0400”)
Example:
- Event created: 2:00 PM in New York (EST, UTC-5)
- Viewed in Dubai: Displays as 11:00 PM (GST, UTC+4)
- Same event, automatically adjusted
Timezone Conversion
When events are saved:
- Event times entered in your local timezone
- Stored in UTC in the database
- Original timezone preserved in
original_timezonefield timezone_convertedflag tracks conversion status
When events are displayed:
- Retrieved from database (UTC)
- Converted to your current timezone
- Displayed in familiar local time
- Duration calculated correctly across timezones
Multi-Timezone Events
Best practices:
- Set your correct timezone in user settings
- Verify timezone when creating important events
- Consider attendee timezones when scheduling
- Use UTC for global team coordination
- Check timezone when traveling
Timezone support:
- Full IANA timezone database supported
- Daylight Saving Time (DST) handled automatically
- Timezone abbreviations displayed (e.g., EST, PST, GST)
- Historical timezone rules respected
Configuring Your Timezone
To set or change your timezone:
- Navigate to Settings → General
- Find the Timezone dropdown
- Select your timezone (e.g., “Asia/Dubai”, “America/New_York”)
- Save settings
- All events automatically adjust to new timezone
Finding your timezone:
- Search by city name
- Search by region (e.g., “America/Los_Angeles”)
- Use standard timezone identifiers
- Check current UTC offset if unsure
Best Practices
Event Creation Best Practices
- Use descriptive titles - Make the event purpose immediately clear (e.g., “Q4 Planning Meeting with Marketing Team” instead of “Meeting”)
- Set accurate times and durations - Help prevent scheduling conflicts and time estimation errors
- Always add location - Especially critical for in-person meetings; include building, room number, or full address
- Write detailed descriptions - Include meeting agendas, preparation requirements, or relevant links
- Invite all participants - Ensure everyone who needs to attend receives the invitation
- Use all-day events appropriately - For holidays, birthdays, deadlines, and date-specific events without specific times
- Link events to tasks - Connect planning meetings to project tasks for better context
- Set reminders - Choose appropriate reminder timing (15 minutes for meetings, 1 day for deadlines)
Calendar Organization Best Practices
- Use multiple calendars - Separate work, personal, projects, and different workspaces
- Apply consistent color coding - Visual organization by calendar type or priority
- Regular calendar review - Check upcoming events daily, weekly planning on Sundays/Mondays
- Keep calendars synchronized - Enable Google Calendar sync for cross-platform access
- Clean up old events - Archive or delete outdated placeholder events
- Respect timezone settings - Verify correct timezone when scheduling across regions
- Block focus time - Create “Do Not Disturb” or “Focus Time” events
- Leave buffer time - Schedule breaks between back-to-back meetings
Google Calendar Sync Best Practices
- Configure properly from the start - Set up Google Calendar integration before creating events
- Monitor sync status regularly - Check for sync failures in event details
- Retry failed syncs promptly - Don’t let sync errors accumulate
- Verify calendar permissions - Ensure you have Owner or Writer access for calendars you want to sync
- Handle conflicts carefully - Understand two-way sync implications before making changes
- Use async sync - Enable background processing for better performance (default setting)
- Set workspace defaults - Configure default calendars per workspace for consistency
- Test after setup - Create a test event and verify it syncs both ways
Collaboration Best Practices
- Send invitations early - Give attendees time to prepare and adjust schedules
- Update event details promptly - Notify attendees of changes via updated invitations
- Track attendee responses - Monitor who has accepted, declined, or not responded
- Add video conferencing links - Use Google Meet integration for remote participants
- Include relevant context - Add meeting materials, links, or documents in the description
- Respect organizer role - Only organizers should make major event changes
- RSVP promptly - Respond to invitations quickly so organizers can plan
- Update your availability - Keep your calendar current so others can schedule effectively
Troubleshooting
Sync Failed
When Google Calendar synchronization fails:
Immediate solutions:
- Click the “Retry” button in the event details
- Check the sync error message for specific details
- Verify your internet connection is stable
- Refresh the page and check sync status again
Configuration solutions:
- Navigate to Settings → Calendar
- Verify your Google Calendar account status is “Connected”
- Check Last Updated Date - if old, reconnection may be needed
- Click “Authorize Google Calendar Access” to re-authorize
- Verify both “Pull from Google Calendar” and “Push to Google Calendar” are enabled
- Ensure the calendar has Owner or Writer access (not just Reader)
Advanced solutions:
- Check Google Calendar API permissions in your Google account settings
- Verify the calendar hasn’t been deleted in Google Calendar
- Look for sync retry count - if high, may need manual intervention
- Check workspace Google Calendar settings for conflicts
- Consider disconnecting and reconnecting the Google account
Event Doesn’t Appear on Timeline
When an event isn’t visible:
Check date range:
- Verify you’re viewing the correct date range
- Use navigation buttons to move to the event’s date
- Click “Today” button then navigate to event date
- Check if event is far in the past or future
Check calendar settings:
- Verify event has been saved successfully
- Check if event is assigned to a visible calendar
- Ensure calendar isn’t filtered out or hidden
- Verify event has a valid date and time set
Check sync status:
- For Google Calendar events, verify sync status is “Synced”
- If “Pending”, wait for background sync to complete
- If “Failed”, use retry button and check sync settings
- Check if event was created in correct workspace
Browser and display issues:
- Refresh the browser page (F5 or Cmd+R)
- Clear browser cache if problem persists
- Try a different browser to rule out browser-specific issues
- Check if event appears in other views (Today page, Upcoming)
Can’t Create Event
When event creation fails:
Permission issues:
- Verify you’re a member of the current workspace
- Check your workspace role (Member, Editor, or Admin)
- Ensure workspace hasn’t been archived or disabled
- Verify you’re logged in with correct account
Required field issues:
- Ensure event title is filled in (required field)
- Verify start date is set (required field)
- Check that end time is after start time
- Validate duration doesn’t exceed 24 hours (for single events)
Calendar selection issues:
- If syncing with Google Calendar, verify calendar is selected
- Ensure selected calendar has proper permissions
- Check if calendar requires Owner/Writer access
- Try selecting a different calendar or creating without sync
System issues:
- Check browser console for JavaScript errors (F12)
- Verify internet connection is stable
- Try refreshing the page and creating again
- Contact workspace administrator if problem persists
Event Time Appears Wrong
When event times don’t display correctly:
Timezone issues:
- Check your user timezone setting (Settings → General)
- Verify timezone matches your current location
- Check if computer system time is correct
- Confirm daylight saving time (DST) is applied correctly
Event-specific issues:
- Open the event and check the timezone field
- Verify original timezone matches intended timezone
- Check UTC offset in event details
- Re-save the event with correct time if needed
Display issues:
- Check if event is all-day (ignores timezone)
- Verify browser timezone detection is working
- Try accessing from different device to isolate issue
- Check if Google Calendar shows correct time (if synced)
Invited Guests Not Receiving Invitations
When attendees don’t receive event invitations:
Email validation:
- Verify all email addresses are correctly formatted
- Check for typos in email addresses
- Ensure emails are separated by commas
- Maximum 100 guests per event - check count
Email delivery:
- Ask guests to check spam or junk folders
- Verify workspace email notifications are enabled
- Check workspace email configuration in settings
- Ensure email server is functioning properly
Google Calendar invitations:
- If synced with Google Calendar, check Google’s invitation settings
- Verify Google Calendar sharing settings allow invitations
- Check if event sync status is “Synced” (not “Failed” or “Pending”)
- Verify guests have permission to view the Google Calendar
Attendee access:
- Ensure invited guests are members of the workspace (if workspace-specific)
- Check if guests need to be added to workspace first
- Verify guests can access Mosic (have accounts if required)
- Test with a known working email address first
Related Documentation
- Settings - Configure calendar preferences, Google integration, and timezone
- Tasks - Link events to tasks for comprehensive project planning
- Today Page - Use calendar in your daily workflow
- Upcoming - View and plan future events
- Workspaces - Understand workspace-based event organization
- Permissions - Learn about event access control
FAQ
Q: Can I have multiple calendars?
A: Yes, Mosic supports multiple Google Calendar accounts and calendars. You can connect several Google accounts, each with their own calendars, and select which calendar to use for each event. Calendars can be organized by workspace, project, or personal use.
Q: Do events sync both ways with Google Calendar?
A: Yes, Mosic provides full two-way synchronization. Events created in Mosic sync to Google Calendar, and events created in Google Calendar appear in Mosic. Updates, deletions, and attendee changes sync in both directions automatically.
Q: Can I make recurring events?
A: Yes, use the “Repeat” tab in the event detail view to configure recurring events. You can set Daily, Weekly, Monthly, or Yearly recurrence patterns. For weekly events, select specific days. Optionally set an end date, or leave blank for indefinite recurrence.
Q: How do I link an event to a task?
A: Use the “Relations” tab in the event detail view. Click to add a relation, select “MTask” as the document type, search for the task, and save. The relation appears in both the event and task views, creating bi-directional linking.
Q: What happens if Google Calendar sync fails?
A: A “Sync failed” indicator appears in the event details with a specific error message. Click the “Retry” button to attempt synchronization again. If retry fails, check your Google Calendar connection status in Settings and verify calendar permissions.
Q: Can attendees edit events they’re invited to?
A: No, invited attendees have view-only access. They can see event details and RSVP (Accept/Maybe/Decline), but cannot edit event information. Only the organizer and workspace admins/editors can modify event details.
Q: What timezone are events displayed in?
A: Events display in your configured timezone (set in Settings → General). When you create or edit events, times are entered in your local timezone. Events automatically convert to each user’s timezone, ensuring everyone sees the correct local time.
Q: Can I add Google Meet links to events?
A: Yes, when creating or editing an event with Google Calendar sync enabled, navigate to the Advanced tab and toggle “Add Video Conferencing” on. Google will automatically create a Google Meet link that’s accessible to all invited guests.
Q: How do I delete an event?
A: Open the event detail modal and click the trash icon in the header. The event is permanently deleted from Mosic and Google Calendar (if synced). Event deletions cannot be undone, so confirm before deleting important events.
Q: What permissions do I need to create events?
A: You need to be a member of a workspace to create events. Members can create events in their workspaces. For Google Calendar integration, you need Owner or Writer access to the selected calendar (Reader access is view-only).
Q: Can I move events between different calendars?
A: Yes, open the event, select a different calendar from the dropdown, and save. Mosic will delete the event from the old Google Calendar and create it in the new one, updating all sync information automatically.
Q: How do recurring events work with Google Calendar?
A: Recurring event patterns configured in Mosic sync to Google Calendar, preserving the recurrence rule. Changes to the recurrence pattern sync both ways. Individual instances can be modified separately in Google Calendar.
Q: What’s the maximum number of guests I can invite?
A: You can invite up to 100 guests per event. Enter email addresses separated by commas in the guest invitation field. All guests receive invitations and can RSVP to the event.