langflow-ai/langflow · error · HTTPException

Custom component creation is disabled

Error message

Custom component creation is disabled

What it means

Error "Custom component creation is disabled" thrown in langflow-ai/langflow.

Source

Thrown at src/backend/base/langflow/api/v1/endpoints.py:1382

                detail="Component templates are still initializing. Please try again in a few seconds.",
            )

    # In admin-only mode, non-admin users may create/refresh only known server
    # templates. Truly custom code creation remains restricted to administrators.
    if (
        getattr(settings, "custom_component_admin_only", False) is True
        and not user.is_superuser
        and not code_hash_matches_any_template(raw_code.code, all_known)
    ):
        raise HTTPException(
            status_code=status.HTTP_403_FORBIDDEN,
            detail="Custom component creation is restricted to administrators",
        )

    if not settings.allow_custom_components and not code_hash_matches_any_template(raw_code.code, all_known):
        # Allow updating to a known server template (core component update),
        # but block truly custom code.
        raise HTTPException(
            status_code=status.HTTP_403_FORBIDDEN,
            detail="Custom component creation is disabled",
        )

    # In restricted mode the request only reached here by matching a known
    # template hash. That hash is a truncated digest, so a second-preimage
    # collision could clear the gate with attacker-controlled bytes. Execute
    # the server's trusted copy keyed by the same hash instead of the client
    # bytes, and fail closed if no trusted source can be recovered.
    effective_code = raw_code.code
    if _requires_component_hash_lookups(settings, user):
        effective_code = get_trusted_code_for_validation(raw_code.code)
        if effective_code is None:
            raise HTTPException(
                status_code=status.HTTP_403_FORBIDDEN,
                detail="Custom component creation is disabled",
            )

View on GitHub (pinned to 976ec789d2)

Solutions

1. Enable custom component creation in the server settings (LANGFLOW_ENABLE_CUSTOM_COMPONENT or equivalent).

When it happens

Trigger: Occurs when custom component creation is disabled by server configuration and a user attempts to create one.

Common situations: See trigger scenarios.

AI-assisted analysis of langflow-ai/langflow@976ec789d2 (2026-08-14). Data as JSON: /api/errors/835c1579f6af75e2. Report an issue: GitHub.