Per Course Custom CSS

To modify the CSS for your course, simply create a file named override.css file in the config directory for your course. For example:


In this file you can change the background colors, fonts, etc. Make sure that the submitty_php user has read access to this file.

Embedding Submitty within an IFrame

The instructor might wish to use Submitty as part of their course website without having students need to go to a separate Submitty url for submissions. This can be achieved with an iFrame:

<iframe src="{$submitty_url}/index.php?course={$course}&semester{$semester}"></iframe>

However, this approach raises the minor annoyance of refreshing the page (that contains the iFrame) generally takes you off the page you were viewing in the iFrame. This can be solved using some javascript:

<script type="text/javascript">
document.addEventListener('DOMContentLoaded', function(){ 
    var url = localStorage.getItem("iframe_url");
    if (url !== null && url != "") {
        document.getElementById("submitty").src = url;
}, false);

function saveUrl(url) {
    localStorage.setItem("iframe_url", url);
<iframe id="submitty" width="100%" height="100%" frameborder=0
src="{$submitty_url}/index.php?course={$course}&semester{$semester}" onLoad="saveUrl('document.getElementById(\"submitty\").contentWindow.location.href');"></iframe>

NOTE: You must have the same domain for the website and Submitty (otherwise it’s cross-scripting and that’s not allowed for security reasons on all major browsers). You can change the url that Submitty uses for each course changing the config.ini file for a particular course and adding a new field to the [hidden_details] section with the key course_url. This will override the base_url that is set in the master.ini file.

The top of the config.ini file would then look something like this:


This URL must still be fully interchangeable with the regular base url from master.ini to ensure that Submitty still works as expected.