githubEdit

Comprehensive Troubleshooting Guide

Resolve common Taskade issues quickly with our comprehensive troubleshooting guide covering everything from basic connectivity problems to advanced workflow debugging.

circle-check

Quick Diagnostic Tools

System Status Check

Before troubleshooting, check if the issue is system-wide:

1

Check Taskade Status

Visit status.taskade.comarrow-up-right to see if there are any known service issues.

2

Test Internet Connection

Ensure you have a stable internet connection by visiting other websites.

3

Clear Browser Cache

Clear your browser cache and cookies for Taskade.com.

4

Try Incognito/Private Mode

Test Taskade in an incognito or private browsing window.

Browser Compatibility

Supported browsers and versions:

Browser
Minimum Version
Recommended Version

Chrome

90+

Latest

Firefox

88+

Latest

Safari

14+

Latest

Edge

90+

Latest

Brave

1.20+

Latest

Login and Authentication Issues

Cannot Log In

Common login problems and solutions:

Email/Password Issues

1

Verify Credentials

Double-check your email address and password for typos.

2

Reset Password

Click "Forgot Password" on the login page and check your email for reset instructions.

3

Check Email Verification

Ensure you've verified your email address by clicking the link in your welcome email.

4

Clear Stored Data

Clear your browser's stored passwords and try logging in again.

Two-Factor Authentication (2FA) Problems

  • Invalid Code: Ensure your device's time is synchronized correctly

  • Lost Device: Use backup codes provided during 2FA setup

  • App Issues: Try generating a new code or reinstalling your authenticator app

  • Recovery: Contact support if you've lost access to both your device and backup codes

Social Login Issues (Google/Microsoft)

  • Permission Denied: Check that you're using the correct Google/Microsoft account

  • Account Linking: Ensure your social account is properly linked to your Taskade account

  • Pop-up Blocked: Allow pop-ups for Taskade.com in your browser settings

  • Third-party Cookies: Enable third-party cookies for authentication to work properly

Account Access Problems

Resolving account-related issues:

Account Locked or Suspended

  1. Check Email: Look for suspension notification emails from Taskade

  2. Review Terms: Ensure you haven't violated Taskade's Terms of Service

  3. Contact Support: Submit a support ticket with your account details

  4. Provide Information: Include any relevant context about recent account activity

Multiple Accounts

  • Account Consolidation: Contact support to merge multiple accounts

  • Email Conflicts: Use different email addresses for separate accounts

  • Workspace Access: Ensure you're logging into the correct account for your workspace

Sync and Data Issues

Projects Not Syncing

Resolve synchronization problems:

Real-time Sync Issues

1

Check Connection

Verify you have a stable internet connection.

2

Refresh Browser

Hard refresh the page (Ctrl+F5 or Cmd+Shift+R).

3

Check Other Devices

Test if the issue occurs on other devices or browsers.

4

Wait and Retry

Sometimes sync delays resolve within a few minutes.

Offline Changes Not Syncing

  • Network Restoration: Ensure your internet connection is fully restored

  • Conflict Resolution: Manually resolve any sync conflicts that appear

  • Data Recovery: Check if offline changes are stored locally and can be manually copied

  • Version History: Use project version history to recover lost changes

Missing or Corrupted Data

Recover lost or corrupted project data:

Missing Projects or Tasks

  1. Check Trash/Archive: Look in archived or deleted items

  2. Search Function: Use the global search to locate missing content

  3. Version History: Access project version history to recover deleted items

  4. Team Member Check: Ask team members if they moved or deleted the content

  5. Backup Recovery: Contact support for data recovery from backups

Formatting Issues

  • Copy-Paste Problems: Avoid pasting complex formatting from other applications

  • Character Encoding: Check for special characters that might cause display issues

  • File Corruption: Re-upload corrupted files or attachments

  • Browser Rendering: Try viewing the content in a different browser

Performance Issues

Slow Loading Times

Optimize Taskade performance:

Browser Optimization

1

Update Browser

Ensure you're using the latest version of your browser.

2

Clear Cache

Clear browser cache, cookies, and stored data for Taskade.

3

Disable Extensions

Temporarily disable browser extensions that might interfere.

4

Check Resources

Close unnecessary tabs and applications to free up system resources.

Network Optimization

  • Bandwidth Check: Test your internet speed and connection quality

  • VPN Issues: Try disabling VPN if you're using one

  • Firewall Settings: Ensure Taskade isn't blocked by firewall or security software

  • DNS Issues: Try switching to public DNS servers (8.8.8.8 or 1.1.1.1)

High CPU or Memory Usage

Reduce resource consumption:

Browser Resource Management

  • Tab Management: Close unnecessary Taskade tabs and projects

  • Extension Conflicts: Identify and disable resource-heavy browser extensions

  • Memory Leaks: Restart your browser periodically to clear memory leaks

  • Hardware Acceleration: Enable or disable hardware acceleration in browser settings

Project Optimization

  • Large Projects: Break down very large projects into smaller, manageable ones

  • Media Files: Optimize or compress large images and attachments

  • Complex Automations: Simplify complex automation workflows that might consume resources

  • Real-time Features: Temporarily disable real-time collaboration if not needed

AI and Automation Issues

AI Agents Not Responding

Troubleshoot AI agent problems:

Agent Configuration Issues

1

Check Agent Status

Verify the agent is active and properly configured.

2

Review Permissions

Ensure the agent has necessary permissions for the requested actions.

3

Test Simple Queries

Try basic questions to test if the agent is responsive at all.

4

Check Knowledge Base

Verify the agent's knowledge base is properly loaded and accessible.

Response Quality Issues

  • Training Data: Ensure the agent has sufficient and relevant training data

  • Prompt Clarity: Use clear, specific prompts and questions

  • Context Limits: Break down complex requests into smaller parts

  • Model Updates: Check if the agent model needs updating or retraining

Automation Failures

Debug automation workflow problems:

Trigger Issues

  • Trigger Conditions: Verify trigger conditions are properly configured

  • Event Detection: Check if the triggering events are actually occurring

  • Permission Problems: Ensure automation has necessary permissions

  • Rate Limiting: Check if automation is hitting API rate limits

Action Failures

  • Integration Status: Verify all integrated services are connected and authorized

  • Data Mapping: Check if data is properly mapped between automation steps

  • Error Logs: Review automation error logs for specific failure reasons

  • Dependency Issues: Ensure all required data and resources are available

Mobile App Issues

Mobile App Problems

Resolve mobile-specific issues:

App Performance

1

Update App

Ensure you're using the latest version of the Taskade mobile app.

2

Restart App

Force close and restart the Taskade app.

3

Restart Device

Restart your mobile device to clear memory and refresh connections.

4

Reinstall App

Uninstall and reinstall the app if problems persist.

Sync Issues on Mobile

  • Background Sync: Enable background app refresh for Taskade

  • Data Connection: Ensure you have a stable cellular or Wi-Fi connection

  • Storage Space: Free up device storage space if running low

  • Battery Optimization: Disable battery optimization for Taskade to prevent sync interruption

Mobile-Specific Features

Troubleshoot mobile feature problems:

Widget Issues

  • Widget Setup: Remove and re-add widgets if they're not displaying correctly

  • Permissions: Grant necessary permissions for widgets to function

  • iOS Shortcuts: Recreate Siri shortcuts if they stop working

  • Android Widgets: Clear widget cache and data if experiencing issues

Notification Problems

  • Permission Settings: Check notification permissions for Taskade

  • Do Not Disturb: Verify Do Not Disturb settings aren't blocking notifications

  • Battery Optimization: Disable battery optimization for consistent notifications

  • Notification Categories: Check individual notification category settings

Integration Issues

Third-Party Service Integration

Resolve integration problems:

Connection Issues

1

Re-authorize Service

Disconnect and reconnect the third-party service integration.

2

Check Service Status

Verify the third-party service is operational and accessible.

3

Update Permissions

Ensure Taskade has necessary permissions for the integrated service.

4

Test Credentials

Verify your credentials for the third-party service are still valid.

Data Transfer Issues

  • API Limits: Check if you've exceeded API rate limits for the integrated service

  • Data Format: Ensure data formats are compatible between services

  • Field Mapping: Verify field mapping is correctly configured

  • Sync Frequency: Adjust sync frequency if experiencing timeout issues

Calendar Integration Problems

Fix calendar sync issues:

Google Calendar

  • Permission Scope: Ensure Taskade has calendar read/write permissions

  • Calendar Selection: Verify you're syncing with the correct calendar

  • Two-way Sync: Check if changes in both directions are syncing properly

  • Time Zone: Ensure time zone settings match between Taskade and Google Calendar

Outlook Integration

  • Account Type: Verify you're using the correct Microsoft account type

  • Exchange Settings: Check Exchange server settings if using corporate Outlook

  • Sync Conflicts: Resolve any calendar sync conflicts that may arise

  • Recurring Events: Test that recurring events sync properly

Workspace and Collaboration Issues

Team Collaboration Problems

Resolve multi-user issues:

Permission Issues

1

Check User Roles

Verify team members have appropriate roles and permissions.

2

Review Workspace Settings

Check workspace-level permissions and access controls.

3

Test Individual Access

Test each user's access to specific projects and features.

4

Update Permissions

Adjust permissions as needed and notify affected users.

Real-time Collaboration Issues

  • Conflict Resolution: Manually resolve editing conflicts between team members

  • Version Control: Use version history to track and resolve conflicting changes

  • Communication: Ensure team members communicate about simultaneous editing

  • Browser Compatibility: Verify all team members are using supported browsers

Sharing and Access Problems

Fix sharing and access issues:

  • Link Generation: Regenerate sharing links if they're not working

  • Permission Levels: Verify sharing links have appropriate permission levels

  • Expiration Dates: Check if sharing links have expired

  • Domain Restrictions: Ensure domain restrictions aren't blocking access

Guest Access

  • Email Verification: Ensure guests verify their email addresses

  • Account Creation: Help guests create accounts if required

  • Browser Support: Verify guests are using supported browsers

  • Firewall Issues: Check if corporate firewalls are blocking guest access

Advanced Troubleshooting

Network and Connectivity

Diagnose network-related issues:

Corporate Network Issues

  • Firewall Configuration: Work with IT to whitelist Taskade domains and ports

  • Proxy Settings: Configure proxy settings if required by your organization

  • SSL Certificate: Ensure SSL certificates are properly configured

  • Content Filtering: Check if content filters are blocking Taskade features

DNS and Routing Issues

  • DNS Resolution: Test DNS resolution for Taskade domains

  • Traceroute: Use traceroute to identify network routing issues

  • CDN Problems: Try accessing Taskade from different geographic locations

  • ISP Issues: Contact your ISP if experiencing persistent connectivity problems

Browser Developer Tools

Use browser tools for advanced debugging:

Console Errors

1

Open Developer Tools

Press F12 or right-click and select "Inspect Element".

2

Check Console Tab

Look for error messages in the Console tab.

3

Note Error Details

Copy error messages and share with support if needed.

4

Clear Errors

Refresh the page and see if errors persist.

Network Tab Analysis

  • Failed Requests: Identify failed network requests and their status codes

  • Load Times: Analyze resource loading times to identify bottlenecks

  • CORS Errors: Check for Cross-Origin Resource Sharing issues

  • API Responses: Examine API response data for debugging

Getting Help

Self-Service Resources

Additional help resources:

  • πŸ“š Help Center: Comprehensive articles at help.taskade.comarrow-up-right

  • πŸŽ₯ Video Tutorials: Step-by-step video guides for common tasks

  • πŸ’¬ Community Forum: Connect with other users and share solutions

  • πŸ“– Documentation: Complete feature documentation and guides

Contact Support

When to contact our support team:

Before Contacting Support

  1. Try Basic Troubleshooting: Follow the relevant steps in this guide

  2. Gather Information: Note error messages, browser version, and steps to reproduce

  3. Check Status Page: Verify there are no known service issues

  4. Document the Issue: Take screenshots or screen recordings if helpful

Support Channels

  • πŸ“§ Email Support: [email protected]envelope

  • πŸ’¬ Live Chat: Available in-app during business hours

  • πŸ“ž Phone Support: Available for Enterprise customers

  • 🎫 Ticket System: Submit detailed support requests through the help center

Information to Include

  • Account Details: Your email address and workspace name

  • Browser/Device: Browser version, operating system, and device type

  • Error Messages: Exact error messages and when they occur

  • Steps to Reproduce: Detailed steps that lead to the issue

  • Screenshots: Visual documentation of the problem

circle-info

Response Times: We typically respond to support requests within 24 hours on business days. Enterprise customers receive priority support with faster response times.

Preventive Measures

Best Practices

Prevent common issues:

Regular Maintenance

  • Browser Updates: Keep your browser updated to the latest version

  • Cache Clearing: Regularly clear browser cache and cookies

  • Extension Management: Periodically review and update browser extensions

  • Account Security: Use strong passwords and enable two-factor authentication

Data Management

  • Regular Backups: Export important projects regularly as backups

  • Version Control: Use version history features to track important changes

  • Access Review: Regularly review team member access and permissions

  • Integration Monitoring: Periodically test and maintain third-party integrations

Performance Optimization

Maintain optimal performance:

  • Project Organization: Keep projects organized and avoid overly complex structures

  • Media Management: Optimize file sizes and remove unnecessary attachments

  • Automation Efficiency: Design efficient automation workflows to reduce resource usage

  • Team Training: Ensure team members follow best practices for collaboration

Last updated