Overview
The Logs page provides a centralized view of system events that occur while using TW Builder. This includes AI requests, template saves, import operations, and any errors that might occur during normal use.
Logs are useful for:
- Debugging issues when features don't work as expected
- Monitoring AI usage and API calls
- Tracking template and page save operations
- Identifying rate limits or API errors
To access the Logs, navigate to TW Builder > Settings and click the Logs tab.
Log Viewer
The log viewer displays recent system events in a table format with the following columns:
| Column | Description |
|---|---|
| Date | When the event occurred, displayed in your local timezone |
| Type | The category of log entry (Error, Warning, Info, Debug) |
| Message | A brief description of what happened |
| Details | Additional context, such as error codes, API responses, or affected elements |
Log Types
Logs are categorized by severity to help you quickly identify important issues:
- Error (red) - Something went wrong that prevented an operation from completing
- Warning (yellow) - Something unexpected happened but the operation continued
- Info (blue) - Normal operations like saves, imports, and AI requests
- Debug (gray) - Detailed technical information for troubleshooting
Filtering
Use the filters above the log table to narrow down the entries you see.
Filter by Type
Click the type dropdown to show only specific categories:
- All Types - Show all log entries (default)
- Errors - Only show errors that need attention
- Warnings - Show warnings and errors
- Info - Show informational entries (excludes debug)
- Debug - Show all entries including debug messages
Filter by Date Range
Use the date pickers to view logs from a specific time period:
- Start Date - Show logs from this date onward
- End Date - Show logs up to and including this date
Click Apply Filter after setting your date range. Click Clear to reset to the default view (last 7 days).
When to Check Logs
The logs page is your first stop when troubleshooting issues with TW Builder.
Common Scenarios
- AI responses are slow or failing - Check for rate limit errors or API authentication issues
- Templates won't save - Look for database or permission errors
- Figma import fails - Check for token expiration or API rate limits
- Page content not updating - Look for AJAX errors or cache issues
- Unexpected behavior - Debug logs may reveal what went wrong
Check logs when AI responses seem slow or fail. Rate limit errors and API authentication issues appear here with specific error codes that can help you identify the problem.
AI-Specific Logs
When using the AI Assistant, the following events are logged:
- AI Request - Every chat message sent to an AI provider
- AI Response - Successful responses with token counts
- Rate Limit - When you've exceeded the provider's request limits
- API Error - Authentication failures, invalid requests, or service outages
AI logs include estimated token usage for cost tracking. See the AI Assistant settings to configure your providers and monitor usage.
Clearing Logs
Over time, the logs table can grow large. To clear old entries:
- Click "Clear Logs" - Button located below the log table
- Choose what to clear - Select a time range (older than 7 days, 30 days, or all logs)
- Confirm deletion - Click "Delete" to permanently remove the selected logs
Cleared logs cannot be recovered. If you're troubleshooting an ongoing issue, export the logs first or take screenshots before clearing.
Log Retention
By default, TW Builder keeps logs for 30 days. Older entries are automatically deleted to prevent database bloat. This setting balances having enough history for troubleshooting while keeping your database clean.
If you need logs for compliance or auditing purposes, consider setting up a separate logging solution or exporting logs regularly.