UI Customization
This is only available in the Enterprise Edition. Please add your license key (get trial key) to activate it.
To help with large-scale deployments, Langfuse allows to customize some key parts of the UI to fit an organization’s environment.
Links
You can customize the links highlighted in the screenshot below:
| Number | Variable | Description |
|---|---|---|
| 1 | LANGFUSE_UI_FEEDBACK_HREF | Replace the default feature request and bug report links with your internal feedback links. |
| 2 | LANGFUSE_UI_DOCUMENTATION_HREF | Customize the documentation link reference in the menu and settings to point to your internal documentation. |
| 3 | LANGFUSE_UI_SUPPORT_HREF | Customize the support link reference in the menu and settings to point to your internal support. |
| 4 | LANGFUSE_UI_API_HOST | Customize the hostname that is referenced in the Langfuse project settings. Defaults to window.origin. Useful if Langfuse is deployed behind a reverse proxy for API requests. |
Co-branding
Co-brand the Langfuse interface with your own logo.
Langfuse adapts to the logo width, with a maximum aspect ratio of 1:3. Narrower ratios (e.g., 2:3, 1:1) also work. The logo is fitted into a bounding box, so there are no specific pixel constraints. For reference, the example logo shown above is 160px x 400px.
| Variable | Description | Example |
|---|---|---|
LANGFUSE_UI_LOGO_LIGHT_MODE_HREF | URL to the logo in light mode. | https://static.langfuse.com/langfuse-dev/example-logo-light-mode.png |
LANGFUSE_UI_LOGO_DARK_MODE_HREF | URL to the logo in dark mode. | https://static.langfuse.com/langfuse-dev/example-logo-dark-mode.png |
LLM API/Gateway Connection defaults
LLM connections are configured in the Langfuse project settings. You can customize the default values via the following environment variables.
| Variable | Description |
|---|---|
LANGFUSE_UI_DEFAULT_MODEL_ADAPTER | Set the default model adapter for the LLM playground and evals. Options: OpenAI, Anthropic, Azure. Example: Anthropic |
LANGFUSE_UI_DEFAULT_BASE_URL_OPENAI | Set the default base URL for OpenAI API in the LLM playground and evals. Example: https://api.openai.com/v1 |
LANGFUSE_UI_DEFAULT_BASE_URL_ANTHROPIC | Set the default base URL for Anthropic API in the LLM playground and evals. Example: https://api.anthropic.com |
LANGFUSE_UI_DEFAULT_BASE_URL_AZURE_OPENAI | Set the default base URL for Azure OpenAI API in the LLM playground and evals. Example: https://{instanceName}.openai.azure.com/openai/deployments |
Product Module Visibility
Control which product modules are visible in the main menu. You can either specify which modules should be visible or which ones should be hidden.
| Variable | Description |
|---|---|
LANGFUSE_UI_VISIBLE_PRODUCT_MODULES | Comma-separated list of modules that should be visible. All other modules will be hidden. Example: tracing,evaluation,prompt-management |
LANGFUSE_UI_HIDDEN_PRODUCT_MODULES | Comma-separated list of modules that should be hidden. All other modules will be visible. Example: playground,datasets |
Available modules:
dashboards: Dashboards except for the default dashboard which is always visibletracing: Traces and usersevaluation: Evaluations and scoresprompt-management: Prompt managementplayground: LLM playgrounddatasets: Datasets
If both variables are set, LANGFUSE_UI_VISIBLE_PRODUCT_MODULES takes precedence. If neither is set, all modules are visible by default.