Web Files Introduction

Web files are the static files your site serves at a fixed address: stylesheets, scripts, fonts, icons and plain HTML files. You manage them in the CMS, and pages and layouts link to them. Use a web file for anything the browser downloads as it is, rather than content that changes per visitor.

Where to find web files

In the admin, open CMS and choose Web Files. Each file has two tabs:

The Explorer in the CMS shows web files alongside every other file in your project.

Example: link a stylesheet

Web files live under app/assets/. In a layout, the asset_url filter turns a path into the file's address:

<link rel='stylesheet' href='{{ 'styles/main.css' | asset_url }}'>

The path is relative to app/assets/, so this links app/assets/styles/main.css.

Web files and uploads are different

A web file is part of your site and is deployed with it. A file a visitor or an editor uploads, such as a photo on a record, is stored with that record instead. Use the Assets module for uploaded files.

Common mistakes

• Typing the full path in asset_url. Start from inside app/assets/.
• Editing a web file in the admin that a developer also deploys. The next deploy replaces it.
• Expecting a change to show at once. Browsers and the cache may keep the old file; check the cache settings on the Details tab.

• Creating a web fileAdd a web file.
• Managing web filesEdit and delete web files.