Custom Site Logo

Custom Site Logo helps you manage your WordPress website’s logo without editing a single line of code. Upload a new logo, or reuse one from your Media Library, then let the plugin place it wherever your site shows its branding — your theme’s header, the login and registration screens, the admin bar, even WooCommerce emails.

If your theme already has a logo slot, switch on one option and the plugin fills it for you. If it doesn’t, drop in a shortcode, a block, a widget, or a one-line template tag.

Put Your Logo Everywhere

• Your theme’s own logo slot — switch on one option and the plugin fills the logo area your theme already has. No shortcode, no template editing.
• A shortcode, block, widget or template tag — use [csl_display_logo] in any post or page, add the “Custom Site Logo” block, drag the widget into a sidebar, or call csl_CustomSiteLogo_show_logo() in your theme.
• The login, registration, and lost-password screens — replace the WordPress logo on those screens with your own, at the width you choose.
• The admin bar and dashboard footer — brand the admin for your clients.
• WooCommerce emails — use your logo as the header image on order and account emails.
• Printed pages — keep your logo (or a print-friendly version of it) on paper.

One Logo Per Situation

• Retina/@2x — a high-resolution logo for crisp display on high-DPI screens.
• Dark mode — an alternate logo shown automatically based on the visitor’s OS/browser colour scheme.
• Mobile — a different logo for small screens, with a breakpoint you control.
• Sticky/shrink on scroll — scale the logo down as the visitor scrolls, and optionally swap in a compact version.
• Per page or post — override the logo on an individual page from the editor sidebar, retina, dark and mobile versions included.
• Size and layout — set a width and height, center the logo, and make it scale to fit smaller screens.
• Hover effects — choose an effect and preview it on the settings page.

For Developers

• REST API — GET /wp-json/custom-site-logo/v1/logo returns the resolved logo, its variants, dimensions and markup, ready for a headless front end.
• Filters — custom_site_logo_settings, custom_site_logo_resolved_image, custom_site_logo_markup and custom_site_logo_structured_data let you change what is resolved and rendered.
• One renderer — the shortcode, block, widget and template tag all render through a single class, so output never drifts between them.

Getting Started

• Built-in Logo Maker — no logo yet? Type your site name, pick a font and colours, and generate a simple text logo right on the settings page. It’s uploaded to your Media Library and set as your logo automatically.
• SVG support — upload SVG logos alongside raster images, with basic upload sanitization.
• Live preview in the Customizer — configure and preview from Appearance » Customize.
• Export, import and reset — back up your configuration as a JSON file, move it to another site, or return everything to defaults.

How to Use It

The quickest route needs no code at all: go to Appearance » Custom Site Logo, upload your logo on the General tab, then switch on “Replace the theme’s logo” on the Display Locations tab. If your theme has a logo area, your logo appears in it.

If your theme has no logo area, you have four options:

1. Add the [csl_display_logo] shortcode to any post or page.
2. Add the “Custom Site Logo” block in the block editor.
3. Drag the “Custom Site Logo” widget into a widget area.
4. Open your theme’s header.php and paste <?php echo csl_CustomSiteLogo_show_logo(); ?> where you want the logo.

The settings screen is split into Logo Maker, General, Size & Layout, Hover Effect, Advanced Logos, Sticky Logo, Display Locations, Login & Registration, and Import / Export.

If you run into any issues setting up the plugin, please reach out via the support forum.

Custom Site Logo Pro

Scheduled logos, conditional rules, SEO controls, and click reports are part of Custom Site Logo Pro. Pro is a separate add-on. Install it next to this plugin and leave both active. This free plugin keeps working on its own, and any Pro settings you have already saved stay stored until Pro is active.

Custom Site Logo Pro adds:

• Conditional Rules — swap the logo between two dates, show one when a condition is met, assign a logo to a language, or rotate through a set of logos. Dated campaigns can repeat every year.
• SEO & Performance — turn the logo link off, open it in a new tab, add nofollow, set a title and ARIA label, add width and height attributes, preload the logo, lazy-load it, and publish Organization structured data.
• Analytics — totals for today, the last 7 days, the last 30 days, and all time, plus daily history, mobile and desktop, top pages, link destinations, CSV export, and a Google Analytics event.
• Logo Sets — a separate logo for the footer, WooCommerce emails, PDF invoices, checkout, the customer account menu, and refund emails. Place one with [csl_pro_logo].
• Campaigns — point a scheduled logo at a sale page, add a Black Friday or Christmas schedule in one click, and email the admin three days before a campaign ends. The same reminder can go to Slack.
• WooCommerce — one logo for a product category, one logo for visitors in a chosen country, and a logo shown during business hours.
• Agency — limit shop managers to the main logo, hold their changes for approval, rename the settings menu, save a Logo Maker wordmark as an SVG, and scan the theme for the logo it uses.
• Logo Lockup block — place a logo together with text.
• Multisite — a network default logo and a network lock, edited from Network Admin.

Pro requires this plugin, version 2.0.0 or newer, WordPress 5.0, and PHP 5.6. Get it at https://kommercely.com/product/custom-site-logo-pro/.

External services

The Logo Maker, on the plugin’s own settings screen, loads font previews from Google Fonts (fonts.googleapis.com). This request runs only in wp-admin, for an administrator viewing Appearance » Custom Site Logo. It sends the font stylesheet request to Google. No front-end visitor is sent there by this plugin. Google Fonts is provided by Google and is subject to Google’s privacy policy.

From your WordPress dashboard

1. Go to Plugins » Add New.
2. Search for “Custom Site Logo”.
3. Click Install Now, then Activate.
4. Go to Appearance » Custom Site Logo to upload your logo and configure it, or Appearance » Customize for a live preview.

Manual installation

1. Upload the custom-site-logo folder to the /wp-content/plugins/ directory.
2. Activate the plugin through the “Plugins” menu in WordPress.
3. Go to Appearance » Custom Site Logo to upload your logo and configure it.

1. 

   The Logo Maker tab — type your site name, pick a font and colors, and generate a text logo without ever leaving the settings page.

2. 

   The General tab — upload or choose a logo, and optionally link it to a custom URL.

3. 

   The Size & Layout tab — set a custom width/height, center the logo, and make it responsive.

4. 

   The Hover Effect tab — pick a hover effect and preview it live.

5. 

   The Advanced Logos tab — configure retina/@2x, dark-mode, and mobile logos.

6. 

   The Import / Export tab — back up your settings as a JSON file, or restore them from one.

2.1.0

Release Date: October 26th, 2026

New features:

• Added a Login & Registration tab. The login logo is also used on the registration and lost-password screens, and it links to your site.
• Added Custom Site Logo Pro as an optional add-on for campaigns, extra logo locations, store logos, analytics, and agency controls. Pro does not replace this plugin.

Updates:

• Conditional Rules, SEO & Performance, and Analytics are now Pro features. The tabs stay on the settings screen. The saved values are kept, and they take effect when Pro is active.
• Scheduled logos, conditional logos, per-language logos, logo rotation, and the network default logo run only when Pro is active.
• New tab, nofollow, disabling the logo link, the title and ARIA label, width and height attributes, preloading, lazy loading, structured data, and click tracking run only when Pro is active.
• Tested up to WordPress 7.1.

Bugfixes:

• Fixed the width and height from Size & Layout not being written onto the logo image.

2.0.0

Release Date: August 22nd, 2026

New features:

• Added an option to fill your theme’s own logo slot, so the logo can be placed without a shortcode or any template editing.
• Added a logo for the login screen, with a configurable width.
• Added a logo for the admin bar and the dashboard footer.
• Added a logo for WooCommerce transactional emails.
• Added a print stylesheet, with the option of a separate print-friendly logo.
• Added a sticky logo that scales down as the visitor scrolls, with an optional compact logo to swap in.
• Added scheduled logos: give a logo a start and end date and it swaps itself in and out.
• Added conditional logo rules based on post type, post/page ID, category, user role, device, the front page, archives, search results, and whether the visitor is logged in.
• Added per-language logos, matched against the locale determined for the current request.
• Added random logo rotation across a set of images, with one picked per page view.
• Added a network-wide default logo for multisite, which individual sites can opt into and still override.
• Added custom alt text, title and ARIA label fields, plus options to open the logo link in a new tab, mark it nofollow, or remove the link entirely.
• Added automatic width and height attributes to prevent layout shift, with the resolved dimensions cached.
• Added optional preloading (with fetchpriority) and optional lazy loading.
• Added optional Organization JSON-LD structured data.
• Added optional logo click tracking, with a stats panel on the settings page and a Google Analytics event.
• Added a REST endpoint, GET /wp-json/custom-site-logo/v1/logo, returning the resolved logo, its variants, dimensions and markup for headless front ends.
• Added retina, dark-mode and mobile versions to the per-page/post logo override.
• Added a logo version selector to the block, along with Dark, Compact and Retina block variations and support for alignment, anchors and spacing.
• Added a Reset button that returns every setting to its default.
• Added a welcome notice that points first-time users at the two things worth doing first.
• Added the custom_site_logo_settings, custom_site_logo_resolved_image, custom_site_logo_markup and custom_site_logo_structured_data filters.

Updates:

• Rebuilt the settings page navigation as a vertical sidebar. The old horizontal tabs had run out of room and were wrapping onto a second row and overlapping the page content.
• Added Sticky Logo, Display Locations, Conditional Rules and SEO & Performance tabs, and collapsed the introductory help text so it no longer pushes the settings down the page.
• The hover-effect stylesheet is now only loaded when a hover effect is actually selected, and the front-end script only when sticky mode or click tracking is enabled. Sites using neither now load no extra CSS or JavaScript.
• Every setting is now declared in one place, with a single default and sanitizer, which the settings page, the Customizer, and the import routine all share.
• Imported settings files are now sanitized through the same whitelist the settings form uses, so an import can no longer introduce an unknown key or an unexpected value.
• Raised the minimum supported WordPress version to 5.0.

Bugfixes:

• Fixed garbled characters in several admin labels and descriptions, where the “»” separator in menu paths such as “Appearance » Customize” displayed as unreadable symbols. Those strings were double-encoded in the previous release.
• Fixed saving from the Customizer being able to silently switch features off, because settings absent from the Customizer’s payload were treated as disabled rather than left alone.
• Fixed random logo rotation picking a different image for each place the logo appeared on a page; one image is now chosen per request.
• Fixed per-page logo overrides dropping the retina, dark-mode and mobile versions.
• Fixed the logo linking to # when no custom URL was set; it now links to your home page.
• Fixed the “no logo uploaded” notice being visible to visitors instead of only to administrators.
• Fixed the Media Library button not working on the newer image fields.
• Fixed the settings form refusing to save when the main logo field was left empty, which made the other tabs impossible to configure first.
• Rate-limited the click-tracking endpoint so it cannot be used to write to the database repeatedly.
• Resolved all PHPCS (WordPress Coding Standards) reported issues across the codebase, and added the plugin’s ruleset so the standard is reproducible.

1.2.0

Release Date: August 15th, 2026

New features:

• Added a “Custom Site Logo” block for the block editor, with a live preview.
• Added a “Custom Site Logo” classic widget.
• Added retina/@2x logo support.
• Added an alternate dark-mode logo, shown automatically based on the visitor’s OS/browser preference.
• Added an alternate mobile logo with a configurable breakpoint.
• Added SVG logo upload support with basic sanitization.
• Added a per-page/post logo override meta box.
• Added a live-preview Customizer section (Appearance » Customize).
• Added settings export/import (as a JSON file).
• Added a “Logo Maker” tab: no logo yet? Type your site name, pick a font and colors, and generate a text logo right on the settings page. It’s uploaded to your Media Library and set as your logo automatically.

Updates:

• Reorganized the settings page into tabs (General, Size & Layout, Hover Effect, Advanced Logos, Import/Export) for easier navigation. The active tab is remembered between visits.
• Redesigned the settings page with a proper page header, thumbnail previews next to every logo field (with a one-click “Remove”), modern on/off toggle switches for checkbox options, and a two-card layout for Import/Export.
• Shrunk the oversized hover-effect preview image on the settings page.

Bugfixes:

• Fixed the “no logo uploaded” notice incorrectly appearing on every page/request; it is now only shown where the logo is actually rendered.
• Fixed a fatal error (TypeError in WP_List_Table::row_actions()) on the Plugins page caused by the “Settings” action link filter.
• Fixed the Media Library upload button being broken on other admin screens due to an unnecessary, globally-loaded Thickbox stylesheet.
• Fixed the logo image field silently storing the literal placeholder text “Select Logo” as its value when no logo was chosen.
• Fixed the “Save Settings” button showing on the Import/Export tab, where it didn’t apply.

1.0.3

Release Date: August 14th, 2026

Updates:

• Resolved all PHPCS (WordPress Coding Standards) reported issues across the codebase.
• Escaped all admin and front-end output, and added a nonce-safe check around the settings-saved notice.
• Fixed the [csl_display_logo] shortcode to correctly return its markup instead of echoing it directly.
• Added an alt attribute to the rendered logo image for better accessibility.
• Clarified and improved the wording of settings page labels, descriptions, and messages.
• Corrected a translation domain mismatch on the plugin’s “Settings” action link.
• Updated “Tested up to” to the latest WordPress version.

1.0.2

Release Date: May 09th, 2023

Bugfixes:

• Fixes PHP Function.

1.0.1

Release Date: May 25th, 2023

Bugfixes:

• Fixes PHP warnings.

Updates:

Update the code standards.