> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# advanced:button

export const LwTemplate = ({title = "Key questions to get you started", icon = "sparkles", cta = "Powered by Agent Studio", linkHref = "https://lucidworks.com/demo/?utm_source=docs&utm_medium=referral&utm_campaign=docs_cta_ai"}) => {
  const [isLoaded, setIsLoaded] = useState(false);
  useEffect(() => {
    const timer = setTimeout(() => {
      setIsLoaded(true);
    }, 500);
    return () => clearTimeout(timer);
  }, []);
  return <div className="lw-template-container">
      <Card title={title} icon={icon}>
        {isLoaded && <span dangerouslySetInnerHTML={{
    __html: `<lw-template id="a029c1a9-28be-427e-b0e1-5d918920246a"></lw-template
            >`
  }} />}
        <Link href={linkHref} className="agent-studio-link text-left text-gray-600 gap-2 dark:text-gray-400 text-sm font-medium flex flex-row items-center hover:text-primary dark:hover:text-primary-light group-hover:text-primary group-hover:dark:text-primary-light">Powered by Lucidworks Agent Studio</Link>
      </Card>
    </div>;
};

[localhost link]: http://localhost:3000/docs/4/app-studio/reference/tags/lightning.directive.advancedButton

[mintlify link]: https://doc.lucidworks.com/docs/4/app-studio/reference/tags/lightning.directive.advancedButton

[old doc.lw link]: https://doc.lucidworks.com/app-studio/4.2/1186

<LwTemplate />

## Description

Creates a button for triggering the advanced search.

## Usage

as element:

```xml wrap  theme={"dark"}
<advanced:button
       [button-label="{string}"]
       [search-within-checkbox="{boolean}"]
       [search-within-label="{boolean}"]
       [search-within-default-value="{boolean}"]
       [action="{string}"]>
</advanced:button>
```

#### Parameters

| Param                                     | Type        | Details                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| button-label  *(optional)*                | **string**  | Label for the button                                                                                                                                                                                                                                                                                                                                                                                                          |
| search-within-checkbox  *(optional)*      | **boolean** | Show the 'search within' option as a checkbox. This enables the query to retain the filters already applied when checked. If not checked the search is reset when a query is entered and the form submitted. If you want this functionality but don’t want a checkbox showing, you can use this attribute set to be false, and set `search-within-default-value` to be true - this uses a hidden field instead of a checkbox. |
| search-within-label  *(optional)*         | **boolean** | The label for the 'search within' checkbox.                                                                                                                                                                                                                                                                                                                                                                                   |
| search-within-default-value  *(optional)* | **boolean** | Whether to enable 'search within' by default. The default is option is 'false'.                                                                                                                                                                                                                                                                                                                                               |
| action  *(optional)*                      | **string**  | Page the search should take place on, results will not change automatically when an action is set.                                                                                                                                                                                                                                                                                                                            |