# How do I apply CSS?

> Upload a CSS file, link to it from an XML Block, and attach that Block to a Template region at the Template, Configuration, or Page level.

URL: https://www.hannonhill.com/cascadecms/latest/articles/developing-in-cascade/css/apply-css.html
category: Developing in Cascade
article-type: how-to
content-kind: faq
release-availability: all
tags: design, templates, blocks
updated: 2026-10-06

You apply CSS at the Template, Configuration, or Page level by linking to it in an XML Block.

## Create a region in your Template

1. Navigate to your Template and click **Edit**.
1. Add a System Region tag within the `<head>` tags, for example `<​system-region name="CUSTOM CSS"/>`.
1. **Submit** your changes.

## Upload your CSS

1. Click **Add Content** and select the **File** asset type.
1. Drag and drop or choose your CSS file, then click **Submit**.

## Create an XML Block

1. Click **Add Content** and select **Block > XML**.
1. Add a link to your CSS file in the code editor and click **Submit**:

```html
<link href="/_cascade/css/custom.css" rel="stylesheet" type="text/css"/>
```

## Attach your XML Block

At the Template or Page level:

1. Navigate to your Template or Page and click **Edit** > **Configure**.
1. Find the region you created, click **Choose Block**, select your XML Block, and click **Choose**.
1. Click **Submit**.

Or at the Configuration level:

1. Click **Manage Site** > **Configurations**, select your Configuration, and click **Edit**.
1. Find the region you created, click **Choose Block**, select your XML Block, and click **Choose**.
1. Click **Submit**.