Softr App Troubleshooting Guide

This article provides a structured approach for Help Desk technicians to troubleshoot common issues with Softr applications, covering data syncing, user authentication, and application performance.

1. Initial Assessment
Before diving into complex fixes, perform these initial checks:

• Check Softr Status: Confirm if the issue is a widespread outage by checking the official Softr status page.
• Identify the Scope: Determine if the problem affects one user, a specific group, or the entire application.
• Clear Browser Cache: Many UI glitches are resolved by clearing the browser cache or testing in an incognito window.

2. Common Data & Syncing Issues
Softr commonly connects to Airtable or Google Sheets. Most data issues stem from integration breaches.

Airtable Data Not Updating

• Check Data Source Sync: Ensure the data source is properly connected in App Settings > Data Sources.
• Verify API Keys: Verify that the Airtable API key has not been changed or revoked in Airtable. Re-paste the key if necessary.
• API Limits: If the application is large, check if you have exceeded Airtable's API rate limits.
• Force Sync/Check Structure: Ensure table/field names haven't been changed in Airtable, which breaks the mapping in Softr.

Data Not Appearing (Specifically in List Blocks)

• Check Conditional Filters: Ensure that user-specific filters in the Softr block settings are not mistakenly hiding data.
• Check User Permissions: Confirm the logged-in user belongs to the correct user group allowed to see that data.

3. User Authentication & Access Issues

• Magic Link Failures: If users aren't receiving magic links, check the email provider settings or spam filters.
• User Not Found: Verify that user records exist in the backend (Airtable/Softr DB) and that the user hasn't signed up using a different email.
• Login Loops/Blank Screens: Often caused by outdated browser sessions. Clear cookies/cache.
• "Site can't be reached": If this occurs, it is likely a network issue or an application outage.

4. Performance & Loading Issues

• Slow Load Times: If the app is sluggish, check if the linked Airtable base has excessive records or complex formulas (e.g., ArrayUnique).
• Broken Components: If specific blocks (like maps or forms) are not rendering, test on a different browser. Sometimes, browser extensions (like adblockers) can interfere with Softr.
• Broken Images/Files: If files are not showing, verify the field type in Airtable is set to "Attachment".

5. Troubleshooting Steps for "Softr Studio"
If the issue is in the editor (Studio) rather than the live app:

• Re-authenticate Data Sources: Go to Data Source > Settings and re-link the database to refresh API tokens.
• "Preview as User" Issues: If this feature fails, ensure you have set up a valid user group for testing.
• "Copy to" Function Errors: High usage of "copy to" can lead to temporary studio lag.