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

# layout:include

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

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

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

<LwTemplate />

## Description

The include directives allows you to include a template on the page.

## Usage

as element:

```xml wrap  theme={"dark"}
<layout:include
       file="{string}">
</layout:include>
```

### Directive info

* This directive creates new scope.

#### Parameters

| Param | Type       | Details                                  |
| ----- | ---------- | ---------------------------------------- |
| file  | **string** | The location of the file of the template |

## Example

#### Source

```xml wrap  theme={"dark"}
<h3 id="example_static-file-path">Static File Path</h3>
<layout:include file="css/user-defined-template.tmp.html" user="{{user}}" file-path="{{filePath}}"></layout:include>
<hr />
<h3 id="example_dynamic-file-path">Dynamic File Path</h3>
<layout:include file="{{filePath}}" user="{{user}}" file-path="{{filePath}}"></layout:include>
<hr />
<h3 id="example_dynamic-2-part-file-path">Dynamic 2 Part File Path</h3>
<layout:include file="{{partFilePath1 + partFilePath2}}" user="foo" file-path="{{filePath}}"></layout:include>
<hr />
<h3 id="example_dynamic-file-path-+-static-file-path">Dynamic File Path + Static File Path</h3>
<layout:include file="{{partFilePath1 + 'tmp.html'}}" user="foo" file-path="{{filePath}}"></layout:include>
<hr />
<h3 id="example_multi-level">Multi-level</h3>
<layout:include file="css/level1.tpl.html" leveltype="Parent" child="css/level2.tpl.html"></layout:include>
```

```js wrap  theme={"dark"}
angular.module('lightning')
.controller('ExampleController', ['$scope', function($scope) {
            $scope.user = 'Developer';
            $scope.filePath = 'css/user-defined-template.tmp.html';
            $scope.partFilePath1 = 'css/user-defined-template.';
            $scope.partFilePath2 = 'tmp.html';
        }]);
```

#### Result

<img src="https://mintcdn.com/lucidworks/ENcE8K39c0iEpL8J/assets/images/app-studio/as-examples/tags/layoutInclude.png?fit=max&auto=format&n=ENcE8K39c0iEpL8J&q=85&s=6c5050d6d49ce1b203b2925e12d59a88" alt="Result" width="1024" height="1466" data-path="assets/images/app-studio/as-examples/tags/layoutInclude.png" />