How to customise an existing view

Oscar has many views. This How-to describes how to customise one of them for your project. It builds upon the steps described in Customising Oscar. Please read it first and ensure that you’ve:

  • Created a Python module with the the same label
  • Added it as Django app to INSTALLED_APPS
  • Added a and


Create a new homepage view class in myproject.promotions.views - you can subclass Oscar’s view if you like:

from oscar.apps.promotions.views import HomeView as CoreHomeView

class HomeView(CoreHomeView):
    template_name = 'promotions/new-homeview.html'

In this example, we set a new template location but it’s possible to customise the view in any imaginable way. As long as the view has the same name as the view you’re replacing, and is in an app with the same name, it will get picked up automatically by Oscar.

If you want to change the template, create the alternative template new-homeview.html. This could either be in a project-level templates folder that is added to your TEMPLATE_DIRS settings, or a app-level templates folder within your ‘promotions’ app. For now, put something simple in there, such as:

        <p>You have successfully overridden the homepage template.</p>