Theme Headers & Footers

Adding additional stylesheets and JavaScript to CTFd

CTFd allows for admins to set Cascading Style Sheets (CSS) rules and JavaScript (JS) code that applies to the user facing portion of the site. This allows admins to make simple style changes without having to create entirely new custom themes.

The configured theme must have been programmed to use this behavior.

Theme Header

In the admin panel, under Config > Appearances, you can edit the CSS & JS used for your CTFd instance as part of the theme header.

The theme header is loaded as part of the <head> element before the <body> tag of the page. Here you can add whatever HTML, CSS, or JS you would like such as changing the fonts or scripts used for your theme.

You can also edit the CSS & JS loaded through the Theme footer as well. The theme footer is loaded at the end of the page, just before the closing </body> tag.

Example

Setting the theme header as such will change the font to a different family. While this example only demonstrates CSS, you can also add in custom JS files or modify other aspects of the page using HTML.

<link href="https://fonts.googleapis.com/css?family=Oswald&display=swap" rel="stylesheet">
<style>
:not(i) {
    font-family: 'Oswald', sans-serif !important;
}
</style>

Theme Settings

Theme settings provides specific setting options for certain themes inside of the Settings Editor. For the core theme you can choose challenge-window-size, which specifies how wide the modal pop-up for challenges will be (small, normal, large, extra large). For the learning theme you can select challenge-window-size and Challenge Ordering.


Last modified August 23, 2021