After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Uploading Your Logo

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

The size and location of the logo in the header is determined by the store theme. Your logo can be saved as either a GIF, PNG, or JPG (JPEG) file type and uploaded from the Admin of your store.

Logo in Header

The logo image resides in the following location on the server. Any image file with the name logo.gif is used as the default theme logo.

Full path app/design/frontend/[vendor]/[theme]/web/images/logo.gif
Relative path images/logo.gif

If you do not know the size of the logo or other images used in your theme, open the page in a browser, right-click the image, and inspect the element.

In addition to the logo in the header, your logo also appears on email templates and on PDF invoices and other sales documents. The logos used for email templates and invoices have different size requirements, and must be uploaded separately. To learn more, see Communications.

  1. On the Admin sidebar, go to Content > Design > Configuration.

    Design Configuration page

  2. Find the store view that you want to configure and click Edit in the Action column.

  3. Expand the Header section.

    Header settings

  4. To upload a new logo, click Upload and choose the file from your system.

  5. Enter the Logo Image Width and Logo Image Height in pixels.

  6. For Logo Image Alt, enter the text that you want to appear when someone hovers over the image.

  7. When complete, click Save Configuration.

Logo file formats

File format Description
PNG (Portable Network Graphics) This newer alternative to the GIF format supports up to 16 million colors (24 bit). The lossless compression format produces a high-quality bitmap image with crisp text, but a larger file size than some formats. The PNG format supports transparent layers, and is designed to be both viewed and streamed online.
GIF (Graphics Interchange Format) A widely supported, and older bitmap format that is limited to 256 colors (8 bit). The GIF format supports simple animation and transparent layers.
JPG (JPEG) (Joint Photographics Expert Group) A compressed bitmap format that is used by most digital cameras. The lossy compression causes some data loss, which is sometimes noticeable as blurry spots in text.