---
title: "Overriding templates"
manual: "Academic Projects"
version: "main"
source: "Templates/Override/Index.rst"
rendered: "2026-09-22T20:39:25+00:00"
---

# Overriding templates {#templates-override}

EXT:academic_projects is using Fluid as template engine.

This documentation won't bring you all information about Fluid but only the
most important things you need for using it. You can get
more information in the section [Fluid templates of the Sitepackage tutorial](https://docs.typo3.org/m/typo3/tutorial-sitepackage/main/en-us/FluidTemplates/Index.html#fluid-templates). A complete reference of Fluid ViewHelpers
provided by TYPO3 can be found in the  [ViewHelper Reference](https://docs.typo3.org/other/typo3/view-helper-reference/main/en-us/Index.html#start)

## Change the templates using TypoScript constants {#change-the-templates-using-typoscript-constants}

As any Extbase based extension, you can find the templates in the directory
`Resources/Private/`.

If you want to change a template, copy the desired files to the directory
where you store the templates.

We suggest that you use a sitepackage extension. Learn how to
[Create a sitepackage extension](https://docs.typo3.org/m/typo3/tutorial-sitepackage/main/en-us/Index.html#start).

```typoscript
# TypoScript constants
plugin.tx_academicprojects {
    view {
        templateRootPath = EXT:mysitepackage/Resources/Private/Extensions/myextension/Templates/
        partialRootPath = EXT:mysitepackage/Resources/Private/Extensions/myextension/Partials/
        layoutRootPath = EXT:mysitepackage/Resources/Private/Extensions/myextension/Layouts/
    }
}
```

## The image of a project {#the-image-of-a-project}

The project list item and the project page template render their image through
the shared partial `Academic/Image.html` of `EXT:academic_base`, whose
arguments and presets are documented in the `Templates` chapter of that
extension.

Two consequences for an override:

-   Overriding `Project/Item.html` alone changes where the image sits,
    not how it is rendered. To change the markup, the breakpoints or the
    widths, place an `Academic/Image.html` of your own in the partial
    root path above.
-   The partial root path of `EXT:academic_base` is registered below the
    constant above, so the copy wins. A view of your own that renders
    `Project/Item.html` \- a page object, for example - has to list that
    path itself, or the rendering fails on a partial it cannot resolve. Pick a
    key of your own rather than the one this extension uses, and list it under
    `paths` too if your page object is a `PAGEVIEW`, which reads no
    `partialRootPaths`:

    ```typoscript
    # TypoScript setup
    page.10 {
        partialRootPaths.-1700000001 = EXT:academic_base/Resources/Private/Partials/
        paths.-1700000001 = EXT:academic_base/Resources/Private/
    }
    ```
