Be part of JetBrains PHPverse 2026 on June 9 – a free online event bringing PHP devs worldwide together.

bridgeyuwa's avatar

Flux Component Error: "select.option.variants.custom" Does Not Exist

I'm running Laravel 12.2.0 with PHP 8.4.4 and using Livewire Flux. When accessing my site, I get this error:

Internal Server Error

Exception
Flux component [select.option.variants.custom] does not exist.

The error originates from the file: vendor/livewire/flux/stubs/resources/views/flux/select/option/index.blade.php (line 10).

It appears that Flux is trying to load a variant component using this code:

@php
// If the variant is coming from the parent component and is not default, we need to use the custom variant...
$variant = $variant === 'default' ? 'default' : 'custom';
@endphp

<flux:with-field :$attributes>
    <flux:delegate-component :component="'select.option.variants.' . $variant">{{ $slot }}</flux:delegate-component>
</flux:with-field>

If the variant isn’t 'default', it defaults to 'custom'—but apparently, Flux doesn't have the select.option.variants.custom component available. I've already cleared Laravel caches and rebuilt assets, but the issue persists.

Has anyone encountered this error or have insights on how to properly register or configure the custom variant for Flux? Any help or suggestions would be appreciated.

0 likes
1 reply
RemiM's avatar

From the documentation, the custom select is only available in the Pro version of Flux.

In short, I believe you can only use the default value in the variant props in the free tier, but it's not necessary to add the props as it's the default value anyway.

Please or to participate in this conversation.