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 screen, 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 screen — replace the WordPress logo on wp-login.php 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.
• Scheduled — set a start and end date for a seasonal or campaign logo, and it swaps itself in and out.
• Conditional — show a different logo based on post type, a specific page, category, user role, device, the front page, archives, search results, or whether the visitor is logged in.
• Per language — assign a logo to each locale on a multilingual site.
• Random rotation — cycle through a set of logos, one picked per page view.
• Per page or post — override the logo on an individual page from the editor sidebar, retina, dark and mobile versions included.
• Network-wide — set one default logo every site in a multisite network falls back to.

Speed, SEO and Accessibility

• No layout shift — width and height attributes are added automatically so the page doesn’t jump while the logo loads.
• Loads only what it needs — the hover-effect stylesheet is only enqueued when you actually pick a hover effect, and the script only when sticky mode or click tracking is on.
• Optional preloading — hint to the browser to fetch your logo early, for a faster Largest Contentful Paint.
• Optional lazy loading — for logos that sit below the fold.
• Structured data — output Organization JSON-LD so search engines can associate the logo with your site.
• Accessibility and link control — set your own alt text, title and ARIA label, open the link in a new tab, add nofollow, or turn the link off entirely.

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.
• Click tracking — see how often your logo is clicked, with an optional Google Analytics event.

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.

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