> For the complete documentation index, see [llms.txt](https://docs.elsaworkflows.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elsaworkflows.io/guides.md).

# Guides

- [V2 to V3 Migration Guide](https://docs.elsaworkflows.io/guides/migration-v2-to-v3.md): Complete migration guide from Elsa Workflows V2 to V3, covering breaking changes, custom activities, workflows, and concepts.
- [Architecture](https://docs.elsaworkflows.io/guides/architecture.md): High-level overview of Elsa Workflows v3 architecture, covering workflow execution flow, core concepts like bookmarks and triggers, workflow runtimes, and multitenancy.
- [Execution Model](https://docs.elsaworkflows.io/guides/architecture/execution-model.md): Release-backed guide to Elsa's execution model in 3.8.0, covering direct execution, dispatched execution, triggers, bookmarks, stimuli, persistence, and recovery.
- [Workflow Dispatcher Architecture](https://docs.elsaworkflows.io/guides/architecture/workflow-dispatcher.md): Deep dive into IWorkflowDispatcher: the core dispatching abstraction for queuing and executing workflows, covering request types, event ordering, and custom dispatcher implementations.
- [Onboarding](https://docs.elsaworkflows.io/guides/onboarding.md)
- [Hosting Elsa in an Existing App](https://docs.elsaworkflows.io/guides/onboarding/hosting-elsa-in-existing-app.md): Step-by-step guide to integrating Elsa Workflows into an existing ASP.NET Core application, including persistence setup, common pain points, and troubleshooting.
- [Authentication & Authorization](https://docs.elsaworkflows.io/guides/authentication.md): Comprehensive guide to configuring authentication and authorization for Elsa Workflows, covering OIDC providers, API keys, custom authentication, and security best practices.
- [Security & Authentication](https://docs.elsaworkflows.io/guides/security.md): Comprehensive guide to securing Elsa Server and workflows end-to-end, covering identity, authentication, tokenized resume URLs, CORS, secrets management, and production hardening.
- [Disable Auth in Development](https://docs.elsaworkflows.io/guides/security/disable-auth.md): Guide for disabling authentication in Elsa Server and Studio during development to simplify local testing and experimentation.
- [HTTP Endpoint Security](https://docs.elsaworkflows.io/guides/security/http-endpoint-security.md): Secure Elsa HTTP workflow endpoints in 3.8.0 by separating workflow ingress authorization from Elsa API permissions and Studio access.
- [External Identity Providers](https://docs.elsaworkflows.io/guides/security/external-identity-providers.md): Release-backed guide to wiring Elsa Server and Elsa Studio to external OpenID Connect identity providers in Elsa 3.8.
- [Deployment](https://docs.elsaworkflows.io/guides/deployment.md)
- [Configuration Management](https://docs.elsaworkflows.io/guides/deployment/configuration-management.md): Manage Elsa Server, Elsa Studio, and modular host configuration with appsettings, environment overrides, and source-backed section names for release 3.8.0.
- [Kubernetes Basics](https://docs.elsaworkflows.io/guides/deployment/kubernetes.md): Quick start guide for deploying Elsa Workflows to Kubernetes with PostgreSQL persistence, including configuration, troubleshooting, and production best practices.
- [Kubernetes Deployment](https://docs.elsaworkflows.io/guides/kubernetes-deployment.md): Complete Kubernetes deployment guide for Elsa Workflows including Helm charts, deployment configurations, ingress setup, autoscaling, monitoring, service mesh integration, and production best practice
- [Integration](https://docs.elsaworkflows.io/guides/integration.md)
- [Blazor Dashboard](https://docs.elsaworkflows.io/guides/integration/blazor-dashboard.md): Guide to integrating Elsa Studio with Blazor Server applications, covering hosting patterns, authentication configuration, and troubleshooting common issues.
- [Clustering](https://docs.elsaworkflows.io/guides/clustering.md): Comprehensive guide to running Elsa Workflows in clustered and distributed production environments, covering architecture patterns, distributed locking, scheduling, and operational best practices.
- [Performance & Scaling](https://docs.elsaworkflows.io/guides/performance.md): Release-backed guidance for measuring and tuning Elsa 3.8.0 throughput without trading away workflow durability or operational visibility by accident.
- [Throughput Tuning](https://docs.elsaworkflows.io/guides/performance/throughput-tuning.md): Small, release-backed Elsa 3.8.0 configuration examples for testing commit, worker, and transactional-outbox tradeoffs under load.
- [API & Client](https://docs.elsaworkflows.io/guides/api-client.md): A release-3.8 reference for Elsa's management API, .NET client interfaces, endpoint permissions, and bookmark-resume callbacks.
- [Persistence](https://docs.elsaworkflows.io/guides/persistence.md): Comprehensive guide to choosing, configuring, and tuning persistence providers for Elsa Workflows v3, covering EF Core, MongoDB, and Dapper, along with retention, migrations, and operational best prac
- [SQL Server](https://docs.elsaworkflows.io/guides/persistence/sql-server.md): Complete guide to configuring SQL Server as the persistence provider for Elsa Workflows v3, including setup, configuration, and migration guidance.
- [EF Core Migrations](https://docs.elsaworkflows.io/guides/persistence/ef-migrations.md): Complete guide to working with Entity Framework Core migrations in Elsa Workflows v3, including custom migrations, DbContext management, and versioning strategies.
- [EF Core Setup](https://docs.elsaworkflows.io/guides/persistence/efcore-setup.md): Minimal example to enable Entity Framework Core persistence for Elsa Workflows, including database provider setup and migrations.
- [MongoDB Setup](https://docs.elsaworkflows.io/guides/persistence/mongodb-setup.md): Minimal example to enable MongoDB persistence for Elsa Workflows, including connection configuration and indexing notes.
- [Dapper Setup](https://docs.elsaworkflows.io/guides/persistence/dapper-setup.md): Minimal example to enable Dapper persistence for Elsa Workflows, including connection provider setup and migrations.
- [Indexing Notes](https://docs.elsaworkflows.io/guides/persistence/indexing-notes.md): Recommended database indexes for Elsa Workflows persistence stores to optimize common query patterns.
- [HTTP Workflows](https://docs.elsaworkflows.io/guides/http-workflows.md)
- [Tutorial](https://docs.elsaworkflows.io/guides/http-workflows/tutorial.md)
- [Programmatic](https://docs.elsaworkflows.io/guides/http-workflows/programmatic.md)
- [Designer](https://docs.elsaworkflows.io/guides/http-workflows/designer.md)
- [External Application Interaction](https://docs.elsaworkflows.io/guides/external-application-interaction.md)
- [Loading Workflows from JSON](https://docs.elsaworkflows.io/guides/loading-workflows-from-json.md)
- [Plugins & Modules](https://docs.elsaworkflows.io/guides/plugins-modules.md): Complete guide to extending Elsa Workflows with custom modules, features, and activities. Learn how to create reusable plugins and distribute them as NuGet packages.
- [Extensibility](https://docs.elsaworkflows.io/guides/modules-and-plugins.md): Learn how to extend Elsa Workflows v3 with custom modules and plugins. Covers module registration, contributing activities, services, and API endpoints with practical examples.
- [Testing & Debugging Workflows](https://docs.elsaworkflows.io/guides/testing-debugging.md): Test custom Elsa activities and workflows with the released Elsa testing fixtures, then diagnose real workflow instances with the journal and runtime tools.
- [Running Workflows](https://docs.elsaworkflows.io/guides/running-workflows.md)
- [Using Elsa Studio](https://docs.elsaworkflows.io/guides/running-workflows/using-elsa-studio.md)
- [Using a Trigger](https://docs.elsaworkflows.io/guides/running-workflows/using-a-trigger.md)
- [Timer and Scheduled Workflows](https://docs.elsaworkflows.io/guides/running-workflows/timer-and-scheduled-workflows.md)
- [Hangfire Integration](https://docs.elsaworkflows.io/guides/running-workflows/hangfire-integration.md): Configure Hangfire as Elsa's durable workflow scheduler.
- [Long-Running Workflows](https://docs.elsaworkflows.io/guides/running-workflows/long-running-workflows.md)
- [Dispatch Workflow Activity](https://docs.elsaworkflows.io/guides/running-workflows/dispatch-workflow-activity.md)
- [Bulk Dispatch Workflows Activity](https://docs.elsaworkflows.io/guides/running-workflows/bulk-dispatch-workflows.md)
- [Studio User Guide](https://docs.elsaworkflows.io/guides/studio.md): A comprehensive guide to using Elsa Studio, the visual designer and admin UI for Elsa Workflows v3.
- [Expressions](https://docs.elsaworkflows.io/guides/studio/expressions.md): Learn how Elsa Studio expression editors map to Elsa Server expression engines, how to access workflow variables, and which syntax choices are actually available in Elsa 3.8.
- [Customization](https://docs.elsaworkflows.io/guides/studio/customization.md): Source-backed guide to the main Elsa Studio customization seams in release 3.8.0, including host composition, branding, menus, widgets, activity pickers, and editor extensibility.
- [Custom UI Components](https://docs.elsaworkflows.io/guides/studio/custom-ui-components.md): Source-backed guide to customizing Elsa Studio input editors in release 3.8.0 using backend UI hints, property UI handlers, and Studio UI hint handlers.
- [Integration](https://docs.elsaworkflows.io/guides/studio/integration.md): Source-backed guide to the Elsa Studio host models available in release 3.8.0, including standalone hosts, custom elements, backend configuration, and authentication.
- [Custom Elements Embedding](https://docs.elsaworkflows.io/guides/studio/integration/custom-elements.md): Source-backed cookbook for embedding Elsa Studio custom elements in release 3.8.0, including backend configuration, authentication, tenant headers, and React usage.
- [Workflow Patterns](https://docs.elsaworkflows.io/guides/patterns.md): A practical, pattern-based guide to designing and implementing common workflow patterns with Elsa Workflows v3. Each pattern provides grounded guidance, code snippets, pitfalls, and references to elsa
- [Troubleshooting](https://docs.elsaworkflows.io/guides/troubleshooting.md): Comprehensive troubleshooting guide for diagnosing and resolving common Elsa Workflows issues in development and production environments.