Best practices
Recommended approaches for building and operating with Retool.
Agents
Tagged pages in the Agents documentation.
Prompting guidance for agents
Best practices for writing effective instructions for Retool Agents.
Guide
Retool Agents best practices
Best practices for Retool Agents.
Concept
Token management for agents
Token management best practices for agents.
Concept
Apps
Tagged pages in the Apps documentation.
Add third-party packages to an app
Add third-party packages to extend the functionality of your app.
Guide
App best practices
Best practices for building apps.
Concept
Manually edit app code
View and edit the code for your app.
Guide
Performance best practices
Best practices for building performant apps.
Concept
Prompting best practices
Best practices for writing prompts to build and edit apps.
Concept
Testing and monitoring best practices for app building
Best practices for evaluating apps built with AI.
Concept
Token management best practices for app building
Token management best practices for app building with AI.
Concept
Classic apps
Tagged pages in the Classic apps documentation.
Build modules to reuse queries and components
Learn how to reuse groups of components and queries across classic apps.
Guide
Classic app best practices
Best practices for building performant classic apps.
Concept
Classic app performance
Best practices for building performant classic apps.
Concept
Module best practices
Best practices for building modules.
Concept
Testing best practices
Best practices for testing classic apps.
Concept
Data sources
Tagged pages in the Data sources documentation.
Connect to AlloyDB
Connect AlloyDB to Retool to query data, manage records, and build apps, workflows, and agents with SQL.
Guide
Connect to Amazon S3
Learn how to connect to Amazon S3 and upload, download, manage files in Retool.
Guide
Connect to Azure Blob Storage
Connect Azure Blob Storage to Retool and upload, download, and manage files in your apps and automations.
Guide
Connect to CockroachDB
Connect CockroachDB to Retool to query data, manage records, and build apps and automations with SQL.
Guide
Connect to CouchDB
Learn how to connect to CouchDB and query, manage documents in Retool.
Guide
Connect to GraphQL
Connect GraphQL APIs to Retool and query and mutate data.
Guide
Connect to Microsoft SQL Server
Connect Microsoft SQL Server to Retool to query data, manage records, and build apps and automations with T-SQL.
Guide
Connect to Microsoft Teams
Connect Microsoft Teams to Retool and manage teams, channels, chats, and messages.
Guide
Connect to MotherDuck
Connect MotherDuck to Retool and query analytics data, build dashboards, and manage records with DuckDB SQL.
Guide
Connect to MySQL
Connect MySQL to Retool to query data, manage records, and build apps and automations with SQL.
Guide
Connect to OneSignal
Connect OneSignal to Retool and send push notifications, manage devices, and track messaging campaigns.
Guide
Connect to PostgreSQL
Connect PostgreSQL to Retool to query data, manage records, and build apps and automations with SQL.
Guide
Connect to Salesforce
Learn how to connect to Salesforce and interact with CRM data, manage records, and execute custom Apex logic in Retool.
Guide
Connect to SendGrid
Connect SendGrid to Retool and send transactional and marketing email, manage contacts, and track email activity.
Guide
Connect to SMTP
Connect an SMTP server to Retool and send email from your apps, workflows, and agents.
Guide
Connect to Snowflake
Connect Snowflake to Retool to query data, manage records, and build apps, workflows, and agents with SQL.
Guide
Connect to Stripe
Connect Stripe to Retool and manage payments, customers, and subscriptions.
Guide
Connect to Twilio
Learn how to connect to Twilio and send SMS messages, make voice calls, and manage communications in Retool.
Guide
Mobile
Tagged pages in the Mobile documentation.
Mobile app best practices
Learn about the best practices for building performant mobile apps.
Concept
Organization & users
Tagged pages in the Organization & users documentation.
Governance in Retool
Learn about governance in Retool.
Concept
Permissions
Tagged pages in the Permissions documentation.
Permissions best practices
Best practices for structuring roles and managing access in Retool using role-based access control (RBAC).
Concept
Queries
Tagged pages in the Queries documentation.
AI resource queries
Learn how to create AI resource queries to generate text, analyze images, and process documents in Retool.
Guide
Query performance best practices
Learn about the best practices for writing performant queries.
Concept
Self hosted
Tagged pages in the Self hosted documentation.
Backup and disaster recovery best practices
Learn how to back up and recover your self-managed Retool instance.
Concept
Capacity planning best practices
Learn how to plan and size your self-managed Retool instance for production workloads.
Concept
Monitoring and alerting best practices
Learn how to monitor and set up alerting for your self-managed Retool instance.
Concept
Security checklist for self-managed Retool
A checklist of security controls to apply before and after deploying self-managed Retool.
Concept
Security hardening best practices
Learn about security hardening options for self-hosted Retool.
Concept
Self-hosted Retool upgrade best practices
Learn about best practices for upgrading your self-hosted Retool deployment.
Concept
Self-managed Retool administration best practices
Best practices for administering, maintaining, and operating self-managed Retool instances.
Concept
Upgrade planning best practices
Learn how to plan and manage Retool upgrades for self-managed instances.
Concept
Source control
Tagged pages in the Source control documentation.
Source Control best practices
Recommendations for structuring branches, instances, and deployments with Source Control.
Concept
SSO
Tagged pages in the SSO documentation.
SSO best practices
Recommendations for configuring, testing, and operating SSO.
Concept
Workflows
Tagged pages in the Workflows documentation.
Token management for workflows
Token management best practices for workflows that query AI resources.
Concept
Workflow performance best practices
Learn about the best practices for building performant workflows.
Concept