Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A template engine which implements a Django-template-like syntax.
Latest commit 9f6442c @flosch Update

GoDoc Build Status

I deactivated the issue tracker and wiki pages for pongo. pongo won't receive bugfixes anymore. Please consider using the successor pongo2 instead. You can find more information and a migration tutorial on my website.

pongo is a well-tested template engine which implements a Django-template-like syntax.

Please have a look at the test (template_test.go) for examples.

A tiny example (template string)

in := "Hello {{ name|capitalize }}!"
tpl, err := pongo.FromString("mytemplatetest", &in, nil)
if err != nil {
out, err := tpl.Execute(&pongo.Context{"name": "florian"})
if err != nil {
fmt.Println(*out) // Output: Hello Florian!

Example server-usage (template file)

package main

import (

var tplExample = pongo.Must(pongo.FromFile("example.html", nil))

func examplePage(w http.ResponseWriter, r *http.Request) {
    err := tplExample.ExecuteRW(w, &pongo.Context{"query": r.FormValue("query")})
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)

func main() {
    http.HandleFunc("/", examplePage)
    http.ListenAndServe(":8080", nil)


See the wiki (work in progress) on GitHub for a documentation/reference:

While I'm working on the wiki content, GoPkgDoc shows a list of implemented filters/tags and an auto-generated documentation on how to use the simple API:

It is possible to add your own filters/tags. See the template_test.go for example implementations.


pongo is still in beta and has a very few known bugs (this is why the tests fail).


pongo is licensed under the MIT-license (see LICENSE file for more).

Something went wrong with that request. Please try again.