Common Issues

Find quick solutions to the most frequently encountered problems with Rytinco. Most issues can be resolved in just a few minutes with these proven troubleshooting steps.

Qlink - QR Code Issues

QR Code Won’t Scan

Most Common Causes & Solutions:

❌ Problem: QR code is too small ✅ Solution:

Minimum size: 2cm x 2cm (0.8 inches)
Recommended: 3cm x 3cm for reliable scanning
For business cards: Test actual print size before ordering

❌ Problem: Poor contrast between colors ✅ Solution:

Use dark colors on light backgrounds
Avoid yellow on white or light blue combinations
Test: If you can’t clearly see the difference, neither can scanners

❌ Problem: Logo is too large ✅ Solution:

Keep logo under 20% of total QR code area
Use high error correction level for larger logos
Test on multiple devices after adding logo

❌ Problem: Damaged or dirty surface ✅ Solution:

Clean the surface with a soft cloth
Replace damaged prints immediately
Use protective coating for outdoor QR codes

❌ Problem: Poor lighting conditions ✅ Solution:

Ensure adequate lighting when scanning
Avoid reflective surfaces that create glare
Position QR codes away from direct light sources

QR Code Redirects to Wrong Page

Quick Diagnostic Steps:

Check the destination URL:
- Log into your dashboard
- Click on the problematic Qlink
- Verify the destination URL is correct
- Ensure URL includes http:// or https://
Test the destination directly:
- Copy the destination URL
- Paste into browser address bar
- If it doesn’t work directly, fix the URL
Clear cache and test:
- Updates take 1-2 minutes to propagate
- Clear browser cache
- Test QR code again
Check for typos:
- Common mistakes: extra spaces, wrong domain
- Use copy/paste instead of manual typing

Analytics Not Recording

Common Analytics Issues:

❌ Problem: No scan data appearing ✅ Solution:

Wait 5-10 minutes - data takes time to process
Check if ad blockers are enabled (can block tracking)
Ensure you’re scanning the actual QR code, not a screenshot
Verify the Qlink is active and not paused

❌ Problem: Geographic data is incorrect ✅ Solution:

VPN usage can skew location data
Mobile networks may show cell tower location
IP geolocation is 85-90% accurate for city level
This is normal - focus on broader geographic trends

❌ Problem: Missing UTM parameters in Google Analytics ✅ Solution:

Verify UTM parameters are set in Qlink settings
Check Google Analytics configuration
Ensure tracking code is properly installed
Allow 24-48 hours for data to appear in GA

Account Issues

Can’t Log In

Login Problem Solutions:

❌ Problem: “Invalid email or password” error ✅ Solution:

Use “Forgot Password” link on login page
Check email (including spam folder)
Create new password following security requirements
Clear browser cookies and try again

❌ Problem: Account locked or suspended ✅ Solution:

Check email for suspension notices
Common cause: failed payment attempts
Update payment method in account settings
Contact support for immediate reactivation

Payment and Billing Issues

Billing Problem Quick Fixes:

❌ Problem: Payment method declined ✅ Solution:

Check with your bank - common cause is fraud protection
Verify card details are entered correctly
Ensure sufficient funds or credit limit
Try a different payment method
Contact billing@rytinco.com

❌ Problem: Can’t find invoice ✅ Solution:

Check spam/junk folder in email
Log into dashboard → Account Settings → Billing
Look in “Invoice History” section
Search email for “Rytinco Invoice”
Contact billing support to resend

❌ Problem: Unexpected charges ✅ Solution:

Review plan upgrade history in dashboard
Check for mid-cycle plan changes (prorated billing)
Verify team member actions (if applicable)
Contact billing support with specific questions

Mobile and Device Issues

Scanner App Problems

Device-Specific Solutions:

iPhone Users:

Use built-in Camera app (most reliable)
Ensure iOS is updated to latest version
Check Camera permissions for QR scanning
Try third-party apps if Camera app fails

Android Users:

Try Google Lens or built-in camera QR scanner
Samsung devices: Use Samsung Internet browser
Update Google Play Services
Clear camera app cache if needed

General Mobile Issues:

Restart phone if scanning suddenly stops working
Check for app updates
Ensure good lighting and steady hands
Clean camera lens

Browser Compatibility

Browser-Specific Issues:

Chrome:

Usually works best for web-based QR scanning
Clear cache: Settings → Privacy → Clear browsing data
Disable ad blockers temporarily

Safari:

Enable camera permissions for websites
Update to latest Safari version
Clear website data if issues persist

Firefox:

Enable camera permissions
Check privacy settings aren’t blocking QR functionality
Try private browsing mode

Performance Issues

Slow Loading Times

Speed Optimization:

❌ Problem: Qlink destination loads slowly ✅ Solution:

Test destination URL directly in browser
Optimize landing page images and content
Consider using Rytinco’s landing page builder
Check mobile optimization of destination

❌ Problem: Analytics dashboard is slow ✅ Solution:

Try different time ranges (shorter periods load faster)
Clear browser cache
Check internet connection speed
Use dashboard during off-peak hours

Server and Connectivity Issues

Connection Problems:

❌ Problem: “Cannot connect to Rytinco” errors ✅ Solution:

Check status.rytinco.com for service status
Try different network (mobile vs WiFi)
Disable VPN temporarily
Clear DNS cache on your device
Contact support if issue persists

❌ Problem: Intermittent Qlink failures ✅ Solution:

Monitor pattern - specific times or locations?
Check mobile network quality in problem areas
Test with different devices
Report patterns to support for investigation

Team and Organization Issues

Team Access Problems

Collaboration Issues:

❌ Problem: Team member can’t access account ✅ Solution:

Verify invitation was sent to correct email
Check spam folder for invitation email
Resend invitation from team settings
Ensure correct role permissions are assigned

❌ Problem: Can’t see other team members’ QR codes ✅ Solution:

Check user role permissions
Organization owners can see all content
Managers typically see team content
Viewers may have limited access

❌ Problem: Team member actions not showing ✅ Solution:

Activity logs may take a few minutes to update
Check correct date range in activity viewer
Verify team member is working in correct organization

Campaign and Marketing Issues

Campaign Performance Problems

Marketing Troubleshooting:

❌ Problem: Low scan rates ✅ Solution:

Analyze QR code placement - is it easily visible?
Check size - make QR codes larger if possible
Add clear call-to-action (“Scan for menu”)
Test competitor locations for comparison

❌ Problem: High scans, low conversions ✅ Solution:

Optimize mobile experience of destination
Simplify landing page design
Ensure fast loading times
Add clear value proposition

❌ Problem: Inconsistent performance across locations ✅ Solution:

Check local network quality
Verify QR code print quality at each location
Analyze foot traffic patterns
Consider location-specific content

Diagnostic Tools

Self-Diagnostic Checklist

Before Contacting Support:

QR Code Checklist:

QR code is at least 2cm x 2cm
High contrast colors (dark on light)
Logo is under 20% of total area
Surface is clean and undamaged
Adequate lighting for scanning
Tested on both iPhone and Android

Account Checklist:

Payment method is current and valid
Account has sufficient Qlinks available
Team permissions are correctly set
UTM parameters configured correctly
Analytics time zone matches business location

Technical Checklist:

Internet connection is stable
Browser is updated to latest version
Cache and cookies cleared
Ad blockers disabled for testing
Destination URL works independently

Testing Tools

Built-in Diagnostic Features:

QR Code Preview: Always use preview before downloading
Test URL: Click destination URL in dashboard to verify
Analytics Real-Time: Monitor scans in real-time during testing
Status Page: Check status.rytinco.com for service issues
Support Chat: Use built-in diagnostic tools during chat sessions

When to Contact Support

Escalation Guidelines

Contact Support Immediately for:

Business-critical Qlinks failing during events or campaigns
Payment issues preventing service access
Security concerns or suspected unauthorized access
Complete analytics failure across all Qlinks
Widespread scanning problems affecting multiple Qlinks

Can Wait for Business Hours:

Design questions or optimization advice
Analytics interpretation help
Feature configuration assistance
Team setup and permissions
Best practices and strategy advice

Quick Support Tips

Help Us Help You Faster:

Try basic troubleshooting first (saves time for everyone)
Include screenshots when describing visual issues
Specify device and browser you’re using
Describe what you expected vs what actually happened
Include timeline - when did the problem start?

Prevention Tips

Avoid Common Issues

Proactive Measures:

Test Everything: Always test QR codes before printing or deployment
Monitor Regularly: Check analytics weekly for unusual patterns
Keep Updated: Ensure payment methods don’t expire
Document Changes: Keep track of what works for future reference
Plan for Scale: Upgrade plans before hitting limits

Best Practices

Ongoing Success:

Regular Backups: Export important analytics data monthly
Team Training: Ensure all team members understand best practices
Performance Reviews: Monthly analysis of campaign performance
Security Checks: Regular password updates and security reviews
Stay Informed: Subscribe to Rytinco updates and feature announcements

Most issues have simple solutions! If these troubleshooting steps don’t resolve your problem, our support team is here to help via live chat, email, or phone.