// Module included in the following assemblies:
//
// * web_console/customizing-the-web-console.adoc

[id="adding-a-custom-logo_{context}"]
= Adding a custom logo and product name

You can create custom branding by adding a custom logo or custom product name. You can set both or one without the other, as these settings are independent of each other.

.Prerequisites

* You must have administrator privileges.
* Create a file of the logo that you want to use. The logo can be a file in any common image format, including GIF, JPG, PNG, or SVG, and is constrained to a `max-height` of `60px`.

.Procedure

. Import your logo file into a config map in the `openshift-config` namespace:
+
[source,terminal]
----
$ oc create configmap console-custom-logo --from-file /path/to/console-custom-logo.png -n openshift-config
----

. Edit the web console's Operator configuration to include `customLogoFile` and `customProductName`:
+
[source,terminal]
----
$ oc edit console.operator.openshift.io cluster
----
+
[source,yaml]
----
apiVersion: operator.openshift.io/v1
kind: Console
metadata:
  name: cluster
spec:
  customization:
    customLogoFile:
      key: console-custom-logo.png
      name: console-custom-logo
    customProductName: My Console
----
+
Once the Operator configuration is updated, it will sync the custom logo config map into the console namespace, mount it to the console pod, and redeploy.

. Check for success. If there are any issues, the console cluster Operator will report a `Degraded` status, and the console Operator configuration will also report a `CustomLogoDegraded` status, but with reasons like `KeyOrFilenameInvalid` or `NoImageProvided`.
+
To check the `clusteroperator`, run:
+
[source,terminal]
----
$ oc get clusteroperator console -o yaml
----
+
To check the console Operator configuration, run:
+
[source,terminal]
----
$ oc get console.operator.openshift.io -o yaml
----
