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.