Skip to main content
If you encounter issues while using Zark AI, these troubleshooting tips can help.

​
Common Issues

If the analysis returns unexpected results, start by checking whether the question was understood as intended. Ask “What query did you run?” or “Explain what you just calculated” to see the interpretation. Often, a slight misunderstanding is easily corrected with clarification. For tips on asking better questions, see Get Better Answers.Data quality issues can also cause unexpected results. If your data has blanks, inconsistent formatting, or duplicate records, these affect calculations. Ask “Are there any data quality issues I should know about?” and Zark AI will flag problems it detected during processing. Learn more about working with data.Sometimes the issue is scope. Results might be filtered to a time period you didn’t expect, or aggregated at a different level than intended. Explicit parameters in your question (“for all of 2024” or “by individual product, not category”) prevent these misunderstandings. See tips for better results for guidance.
Most files process successfully, but occasionally a file might be corrupted, in an unsupported format, or have structural issues that prevent processing. When this happens, you’ll see an error message indicating the problem.For data files, common issues include inconsistent column counts across rows, special characters that confuse parsing, or encoding problems with international text. Zark AI attempts to handle these automatically but may need a cleaner source file in some cases.For documents, issues typically relate to corruption, password protection, or unusual formatting. Scanned documents with very low resolution may not OCR cleanly. Handwritten content is not currently supported.
If Zark AI’s interpretation keeps missing what you’re after, try rephrasing significantly rather than making small adjustments. Different framing can trigger different analytical approaches. See tips for better results for techniques on asking clearer questions.You can also ask for alternatives directly. “What other ways could we look at this data?” or “What questions should I be asking about this?” invites the AI to suggest analytical approaches you might not have considered. For more advanced techniques, explore our tutorials.
Possible Causes:
  • Large data queries
  • Network connectivity
  • Server load
  • Complex requests
Solutions:
  • Try simpler queries (see tips for better results)
  • Check internet connection
  • Wait and retry
  • Break down complex requests
Possible Causes:
  • Query didn’t request graphs
  • Data not available
  • Format not supported
  • Request error
Solutions:
  • Explicitly request graphs in query
  • Check if data is available
  • Try different query format
  • Ask for specific chart types
Possible Causes:
  • Unsupported file format
  • File corruption
  • Upload error
  • Format detection issue
Solutions:
Possible Causes:
  • Query not requesting visuals
  • Data format issue
  • Response type mismatch
  • Request error
Solutions:
  • Explicitly request visuals
  • Try different query format
  • Ask for specific visual types
  • Check response format

​
Account & Login Issues

​
Google Sign-In Issues

Problem: Can’t sign in with GoogleSolutions:
  • Check internet connection
  • Clear browser cache
  • Try different browser
  • Disable browser extensions
  • Try incognito/private mode

​
Permission Issues

Problem: OAuth permissions deniedSolutions:
  • Grant necessary permissions
  • Check account settings
  • Revoke and reconnect
  • Contact support if persistent

​
Can’t Sign In

Problem: Email login not workingSolutions:
  • Verify email address
  • Check password
  • Use “Forgot Password” if needed
  • Verify email verification

​
Email Verification

Problem: Email not verifiedSolutions:
  • Check spam folder
  • Request new verification email
  • Verify email address is correct
  • Contact support if needed

​
Password Issues

Problem: Forgot password or can’t resetSolutions:
  • Use “Forgot Password” link
  • Check email for reset link
  • Check spam folder
  • Contact support if needed

​
Account Not Found

Problem: Account doesn’t existSolutions:
  • Verify email address
  • Check if account was created
  • Try signing up again
  • Contact support

​
Access Denied

Problem: Can’t access accountSolutions:
  • Verify login credentials
  • Check account status
  • Try password reset
  • Contact support

​
Storage Issues

​
File Won’t Upload

Problem: Files fail to uploadSolutions:
  • Check file size limits
  • Verify file format is supported
  • Check internet connection
  • Try smaller files first
  • Retry upload

​
Upload Stuck

Problem: Upload progress stopsSolutions:
  • Check internet connection
  • Cancel and retry
  • Try smaller file
  • Check file integrity
  • Contact support if persistent

​
Tags Not Generated

Problem: Files don’t have tagsSolutions:
  • Wait for processing (tags generate automatically)
  • Check file type (some types tag faster)
  • Try re-uploading file
  • Contact support if tags never appear
Learn more about AI auto-tagging.

​
Incomplete Tags

Problem: Tags seem incompleteSolutions:
  • Tags improve over time
  • Some file types tag better than others
  • Try asking AI to add tags (see AI-powered interaction)
  • Use search to find files

​
Can’t View File

Problem: File won’t displaySolutions:
  • Check file format
  • Verify file integrity
  • Try downloading file
  • Check browser compatibility
  • Contact support

​
Preview Not Working

Problem: File preview failsSolutions:
  • Try different browser
  • Check file format support
  • Download file to view
  • Contact support

​
Can’t Delete Files

Problem: Files won’t deleteSolutions:
  • Check permissions
  • Try refreshing page
  • Check if file is in use
  • Contact support

​
Files Missing

Problem: Files disappearedSolutions:
  • Check trash (30-day retention)
  • Verify folder location
  • Search for files
  • Check if moved
  • Contact support

​
Known Limitations

Current Limitation:Zarklab is a user-facing application and does not provide:
  • API access for developers
  • Webhook integrations
  • Programmatic data access
  • Third-party integrations
What This Means:
  • Use the web interface for all features
  • No developer API available
  • No automated integrations
  • Manual interaction required
How Data Works:
  • Responses show data from when you ask
  • Data doesn’t update automatically
  • Each query fetches fresh data
  • No real-time streaming
What This Means:
  • Ask questions again for updates
  • Data reflects query time
  • No automatic refresh
  • Manual refresh required
Learn more about working with data.
Current Limitations:Some visual formats are not editable:
  • Generated charts may not be editable
  • Some code snippets are read-only
  • Limited customization options
  • Future features coming
What’s Coming:
  • Editable quotes (planned)
  • Image generation via chat (planned)
  • Image editing capabilities (planned)
  • Enhanced customization (planned)
Current Status:Shared Spaces are currently in development:
  • Not yet available
  • Expected release: Late 2025
  • Major UX uplift planned
  • Features being built
See the changelog for updates on shared spaces development.
Current Status:Mobile app is low priority:
  • Web interface is primary
  • Mobile app not currently planned
  • Focus on web experience
  • May be considered later
Why These Exist:
  • Product is user-facing, not developer-focused
  • Focus on core features first
  • Some features in development
  • Roadmap prioritizes key features
Workarounds:
  • Use web interface for all features
  • Ask questions again for updates
  • Use available features
  • Check roadmap for updates

​
Data Analysis Troubleshooting

Check the data itself:
  • “Show me 10 random rows”
  • “How many rows total?”
  • “What values appear in the Status column?”
Column names might not match what you expect if they were cleaned during processing:
  • “Show me the schema” lists the actual column names Zark is using
Nulls often cause surprising results:
  • “How many rows have null values in the amount column?”
When nulls are the issue, decide how to handle them:
  • “Sum amount, treating nulls as zero”
  • “Average amount, excluding null values”
If grouping returns unexpected numbers, verify the grouping:
  • “How many distinct values are in the region column?”
Data cleaning questions help:
  • “Standardize the region column”
  • “Show me what values would group together if we ignored case”
When you’re not sure how Zark interpreted your question:
  • “How did you calculate that?”
  • “What filters did you apply?”
Understanding the interpretation often clarifies unexpected results.

​
Privacy and Security

Your files and conversations are handled with appropriate care for business-sensitive information.Files you upload are processed on secure infrastructure and stored encrypted. Your data is isolated from other users—your files, conversations, and analysis are yours alone.The AI processing your files doesn’t retain information between separate sessions for training or other purposes. What you upload is used to answer your questions and then remains in your shared space until you delete it.When web search is used to supplement your internal data, the searches are anonymized and don’t include your internal information. External sources see generic queries, not your business data.For organizations with specific compliance requirements, additional security configurations may be available. Contact your administrator for details about how Zark AI is configured for your organization.
Need additional help? Contact support for assistance.