> For the complete documentation index, see [llms.txt](https://osl.mistium.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://osl.mistium.com/packages/data/template.md).

# template

> Lightweight `{{ }}` templating with HTML escaping

Use `template` to render small text or HTML templates with data maps.

```javascript
import "std:template"
```

## Example

```javascript
import "std:template"

log template.render("Hello {{name}}", {name: "Ada"})
```

## API reference

### `template`

| Method                                         | Returns  | Description                                                                |
| ---------------------------------------------- | -------- | -------------------------------------------------------------------------- |
| `template.render(tmpl: any, data: object)`     | `string` | Renders interpolation, loops, and shared `if`/`unless` conditional blocks. |
| `template.renderHTML(tmpl: any, data: object)` | `string` | Uses the shared renderer with standard HTML escaping enabled.              |

## Notes

* Prefer `import "std:template"`; the older `import "osl/template"` spelling remains supported.
* Return values such as `array` and `object` are regular OSL values unless a returned object section says otherwise.

## Edge-case behavior

False, zero, and null remain distinct from missing values. Invalid loops, unclosed directives, and all HTML-sensitive characters have controlled behavior. Recursive block rendering returns only the rendered text and reuses scope storage.