static-files.md

+++ title = "Static Files" description = "Serving static files in Echo" [menu.main] name = "Static Files" parent = "guide" +++

Images, JavaScript, CSS, PDF, Fonts and so on...

[Using Static Middleware]({{< ref "middleware/static.md">}})

Using Echo#Static()

Echo#Static(prefix, root string) registers a new route with path prefix to serve static files from the provided root directory.

Usage 1

e := echo.New()
e.Static("/static", "assets")

Example above will serve any file from the assets directory for path /static/*. For example, a request to /static/js/main.js will fetch and serve assets/js/main.js file.

Usage 2

e := echo.New()
e.Static("/", "assets")

Example above will serve any file from the assets directory for path /*. For example, a request to /js/main.js will fetch and serve assets/js/main.js file.

Using Echo#File()

Echo#File(path, file string) registers a new route with path to serve a static file.

Usage 1

Serving an index page from public/index.html

e.File("/", "public/index.html")

Usage 2

Serving a favicon from images/favicon.ico

e.File("/favicon.ico", "images/favicon.ico")