Patial Template


Partial templates allow the ability to import html templates into another template via the normal variable syntax {template}.

Basic example

import partialTemplate from './partialTemplate.html';

export default class Example extends LightningElement {
    partialTemplate = partialTemplate;


In other instances it was noted that large conditonal blocks of HTML could be more organized into seperate template files.

Detailed design

Templates can be rendered into a component one of two ways currently.

A template is a constant and cannot be modified. Partials will inherit this same behavior.

This simplifies things, but still may lead to complications in optimizations [unfamiliar with what this entails, so may need LWC context here]. Example:

get dynamicTemplate() {
    return this.conditonal ? template1 : template2;


Why should we not do this? Please consider:

Note: Developers coming from other frameworks would expect this to work this way.


Partials imported via the template tag and lwc:partial attribute.

// foo.html
<template><p>Value: {value}</p></template>

// component.html
      <template lwc:partial="./foo" value={myBeforeValue}></template>
      <template lwc:partial="./foo" value={myAfterValue}></template>

This syntax greatly cuts down on what would be possible and introduces verbose conditional blocks of if:true that could lend themselves to unnecessary rerenders.

Adoption strategy

Since this is not a breaking change and purely an enhancement to an existing syntax developers adoption will be optional. If they decide to reorganize existing components they'll go in with expectations partials are the way going forward to make complex templates more readable.

In the examples above we may want to recommend reoganization of existing components if one was currently heavily nesting components.

How we teach this

For any developer coming from JSX environment this pattern is already normal practice. Showing a simple example is enough to explain how partials work.

Currently a developer would assume this syntax would include a partial and not .toString() the JS template function.

Unresolved questions