# V 3.1 customization

**URL:** <https://talk.getindico.io/t/v-3-1-customization/2622>\
**Category:** General Discussion\
**Created:** [March 24, 2022, 2:35pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622 "2022-03-24T14:35:12Z")\
**Posts on this page:** 13\
**Page:** 1

<div class="post-metadata">

**Author:** ![Daniele\_Binosi](https://talk.getindico.io/user_avatar/talk.getindico.io/daniele_binosi/32/935_2.png) [@Daniele\_Binosi](https://talk.getindico.io/u/Daniele_Binosi)\
**Post date:** [March 24, 2022, 2:35pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/1 "2022-03-24T14:35:12Z")

</div>

Hello!

I would like to customize my indico instance but have troubles in understanding how to do it.  
In `/opt/indico` I have created the folder `ECT-indico-theme` which contains the directories `css` and `files`. Inside `files` I have the logo file: `ECT_White.png`. In `indico.conf` I have added the lines

```auto
CUSTOMIZATION_DEBUG = True
CUSTOMIZATION_DIR = '/opt/indico/ECT-indico-theme'
LOGO_URL = '/static/custom/files/ECT_White.png'

```

This indeed changes my logo to what I want so very good. Now I am trying to achieve even more customization by adding some custom css and html files. So I have copied the `header.html` in `ECT-indico-theme` (I know I can use inheritance but that was quicker for the moment) and modified it a bit. Restarted indico (both `celery` and `uwsgi`) but got no effect. The question is then: where should I put html files? (I tried also inside the `css` directory but did not work).

Also: is there a way to remove the standard sentence:

`Welcome to Indico. The Indico tool allows you to manage complex conferences, workshops and meetings. To start browsing, please select a category below.`

Thanks a million!

---

<div class="post-metadata">

**Author:** ![Daniele\_Binosi](https://talk.getindico.io/user_avatar/talk.getindico.io/daniele_binosi/32/935_2.png) [@Daniele\_Binosi](https://talk.getindico.io/u/Daniele_Binosi)\
**Post date:** [March 24, 2022, 4:45pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/2 "2022-03-24T16:45:22Z")

</div>

The `Welcome [...]` sentence is located in `/opt/indico/.venv/lib/python3.9/site-packages/indico/modules/categories/templates/display/root_category.html` where there is a

```auto
{% block category_description %}

```

---

<div class="post-metadata">

**Author:** ![bpedersen2](https://talk.getindico.io/user_avatar/talk.getindico.io/bpedersen2/32/25_2.png) [@bpedersen2](https://talk.getindico.io/u/bpedersen2)\
**Post date:** [March 25, 2022, 6:13am UTC](https://talk.getindico.io/t/v-3-1-customization/2622/3 "2022-03-25T06:13:41Z")

</div>

For the category descritption: Just edit it online in the root category.

For other templates: Best way is to enable template-debug in the config file to see where the files need to go. You need to really reproduce the folder structure, so e.g.

```auto
├── css
│ ├── 10-mlzcolors.css
│ └── 20-mlz-loginscreen.css
├── static
│ ├── mlz_logo_inv.png
│ ├── mlz_logo_inv.png.1
│ └── mlz_negative_blue_background_rgb.png
└── templates
    └── core
        ├── assets
        │ └── vars_user.js
        ├── auth
        │ └── login_page.html
        ├── events
        │ ├── contributions
        │ │ └── display
        │ │ ├── contribution_display.html
        │ │ └── _contribution_list.html
        │ └── reminders
        │ └── emails
        │ ├── event_reminder_orig.txt
        │ └── event_reminder.txt
        ├── header.html
        └── indico_base.html

```

---

<div class="post-metadata">

**Author:** ![Daniele\_Binosi](https://talk.getindico.io/user_avatar/talk.getindico.io/daniele_binosi/32/935_2.png) [@Daniele\_Binosi](https://talk.getindico.io/u/Daniele_Binosi)\
**Post date:** [March 25, 2022, 7:48am UTC](https://talk.getindico.io/t/v-3-1-customization/2622/4 "2022-03-25T07:48:28Z")

</div>

This is super-useful, thank you very much. It now works like a charm!

---

<div class="post-metadata">

**Author:** ![Daniele\_Binosi](https://talk.getindico.io/user_avatar/talk.getindico.io/daniele_binosi/32/935_2.png) [@Daniele\_Binosi](https://talk.getindico.io/u/Daniele_Binosi)\
**Post date:** [March 25, 2022, 12:32pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/5 "2022-03-25T12:32:36Z")

</div>

Do you happen to know the name of the css file that is displayed by indico in the home landing page? I need it as a reference to start building up the custom css I want to finally apply.

For example I have put in the css dir of my customization dir the file `10-ect.css` containing

```auto
@import 'base/palette';

div.page.header {
        background-color: $yellow !important;

        .toolbar.global-menu {
                background: #cc6005 !important;
                border-color: #ffffff !important;
        }

```

restarted `celery` and `uwsgi` services but nothing changes. What am I doing wrong?

Thanks!

---

<div class="post-metadata">

**Author:** ![ThiefMaster](https://talk.getindico.io/user_avatar/talk.getindico.io/thiefmaster/32/509_2.png) [@ThiefMaster](https://talk.getindico.io/u/ThiefMaster)\
**Post date:** [March 25, 2022, 4:44pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/6 "2022-03-25T16:44:10Z")

</div>

You cannot use scss constructs (imports or variables) in template customizations…

---

<div class="post-metadata">

**Author:** ![Daniele\_Binosi](https://talk.getindico.io/user_avatar/talk.getindico.io/daniele_binosi/32/935_2.png) [@Daniele\_Binosi](https://talk.getindico.io/u/Daniele_Binosi)\
**Post date:** [March 25, 2022, 4:51pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/7 "2022-03-25T16:51:47Z")

</div>

Right, that was taken from an old presentation about 2.x.  
Still I need to replace some colors in `main.9680268a.css`, I have put it in in the css directory inside my customization directory, modify it, restarted celery and uwsgi and got no effect. Any clue?

Thanks!

---

<div class="post-metadata">

**Author:** ![ThiefMaster](https://talk.getindico.io/user_avatar/talk.getindico.io/thiefmaster/32/509_2.png) [@ThiefMaster](https://talk.getindico.io/u/ThiefMaster)\
**Post date:** [March 25, 2022, 4:54pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/8 "2022-03-25T16:54:38Z")

</div>

I’d check “view page source” to make sure the custom css gets included and use the browser’s dev tools to see why the rule isn’t applied.

---

<div class="post-metadata">

**Author:** ![Daniele\_Binosi](https://talk.getindico.io/user_avatar/talk.getindico.io/daniele_binosi/32/935_2.png) [@Daniele\_Binosi](https://talk.getindico.io/u/Daniele_Binosi)\
**Post date:** [March 25, 2022, 8:50pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/9 "2022-03-25T20:50:37Z")

</div>

Thank you for the tip. Indeed in my customization dir `ECT-indico-theme` under `css` I have `main.9680268a.css`. However when looking at the console it complains:

```auto
GET https://indico-test.fbk.eu/static/custom/css/main.9680268a.css net::ERR_ABORTED 404 (Not Found)

```

Permissions seems fine though…

---

<div class="post-metadata">

**Author:** ![ThiefMaster](https://talk.getindico.io/user_avatar/talk.getindico.io/thiefmaster/32/509_2.png) [@ThiefMaster](https://talk.getindico.io/u/ThiefMaster)\
**Post date:** [March 25, 2022, 8:53pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/10 "2022-03-25T20:53:27Z")

</div>

No need to use the weird names as the standard css files. Just use a name like `custom.css`…

Anyway, if you get a 404 there, most likely there’s something wrong with the permissions/ownership of the CSS file (so xsendfile fails)…

---

<div class="post-metadata">

**Author:** ![Daniele\_Binosi](https://talk.getindico.io/user_avatar/talk.getindico.io/daniele_binosi/32/935_2.png) [@Daniele\_Binosi](https://talk.getindico.io/u/Daniele_Binosi)\
**Post date:** [March 25, 2022, 9:04pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/11 "2022-03-25T21:04:33Z")

</div>

You are right, stupid me had done a chmod 710 on the css file… Now it is working; the only thing is that the console now complains about the following:

```auto
DevTools failed to load source map: Could not load content for https://indico-test.fbk.eu/static/custom/css/main.9680268a.css.map: HTTP error: status code 404, net::ERR_HTTP_RESPONSE_CODE_FAILURE

```

Notice that I did hange the name to `custom.css` for my custom css file. So I am not sure if I can simply ignore this

---

<div class="post-metadata">

**Author:** ![ThiefMaster](https://talk.getindico.io/user_avatar/talk.getindico.io/thiefmaster/32/509_2.png) [@ThiefMaster](https://talk.getindico.io/u/ThiefMaster)\
**Post date:** [March 25, 2022, 9:06pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/12 "2022-03-25T21:06:16Z")

</div>

Safe to ignore that warning

---

<div class="post-metadata">

**Author:** ![Daniele\_Binosi](https://talk.getindico.io/user_avatar/talk.getindico.io/daniele_binosi/32/935_2.png) [@Daniele\_Binosi](https://talk.getindico.io/u/Daniele_Binosi)\
**Post date:** [March 25, 2022, 9:07pm UTC](https://talk.getindico.io/t/v-3-1-customization/2622/13 "2022-03-25T21:07:56Z")

</div>

Great! Thank you for all the help!
