> ## 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.

# series:pivot

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.seriesPivot

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

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

<LwTemplate />

## Description

To render information in a pivot facet use the Series Pivot tag, this
tag has to be nested within a
[Chart Display tag](/docs/4/app-studio/reference/tags/lightning.directive.chartDisplay). Please note
it will only render the second level of relevant filters. For more
details see the data object used in the examples below.

You can use the `response` attribute to load the data from the response.
You will also need to include the `query` directly on this tag if you
wish for the user to be able to filter using the data of this series or
alternatively add the `query` to the
[Chart Display tag](/docs/4/app-studio/reference/tags/lightning.directive.chartDisplay).

For detail on how to change the color and background color see the demo
below, for more detail on what you can change and set using CSS see
[here.](http://www.highcharts.com/docs/chart-design-and-style/style-by-css)

When rendering pivot facet data it is recommended that you always
include the [Chart Legend tag](/docs/4/app-studio/reference/tags/lightning.directive.chartLegend) within your [Chart Display tag](/docs/4/app-studio/reference/tags/lightning.directive.chartDisplay) as the examples below show.

## Usage

as element:

```xml wrap  theme={"dark"}
<series:pivot
       response="{string}"
       name="{string}"
       type="{string}"
       [show-marker="{string}"]
       [action="{string}"]
       [query="{object}"]
       [select="{string}"]>
</series:pivot>
```

### Directive info

* This directive creates new scope.

#### Parameters

| Param                     | Type       | Details                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| response                  | **string** | The name of the response to get the facet from.                                                                                                                                                                                                                                                                                                                                                                                             |
| name                      | **string** | Name of facet.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| type                      | **string** | Chart type                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| show-marker  *(optional)* | **string** | Whether to show marker or not.                                                                                                                                                                                                                                                                                                                                                                                                              |
| action  *(optional)*      | **string** | The page/action to which clicking the chart should be submitted. By default the action points to the current page.                                                                                                                                                                                                                                                                                                                          |
| query  *(optional)*       | **object** | The search query from which to build links.                                                                                                                                                                                                                                                                                                                                                                                                 |
| select  *(optional)*      | **string** | How the data should be filtered when clicking on a part of the chart, a valid query must be present.  Valid values:  <br /> **false**  User selects a filter by clicking the value;  **(default)**  <br /> **multiselect**  Supports selecting multiple filters that get combined with an 'OR'.  <br /> **multiselect-instant**  Supports selecting multiple filters that get combined with an 'OR', filters will be applied automatically. |