Logo, Favicon, Site Name & Header Navigation
Everything on this page is done from wp-admin — never by editing theme files, so your
changes survive theme updates. The theme registers no extra Customizer panel; it relies
on core WordPress screens.
Where to change what
| What | wp-admin location | What the theme does with it |
|---|---|---|
| Site name | Settings → General → Site Title | Printed as a text link inside .site-branding (only while no logo is set) and used by the theme’s title-tag support for <title> |
| Tagline | Settings → General → Tagline | Printed next to the brand |
| Logo | Appearance → Customize → Site Identity → Logo | The theme declares custom-logo with a recommended 96×96 (flexible width/height). Once set, the logo replaces the text brand |
| Favicon | Appearance → Customize → Site Identity → Site Icon | WordPress core outputs the icon links — the theme adds no favicon markup of its own |
| Header menu | Appearance → Menus → assign to Primary Menu | Rendered by the theme’s own walker (chevron on parents + dropdown panel) |
| Footer menu | Appearance → Menus → assign to Footer Menu | The theme’s second registered menu location |
1. Site name and tagline
Change the values
Settings → General → Site Title and Tagline → Save Changes.
Check two places
The browser tab (the theme supports title-tag, so WordPress builds <title>) and the
header brand on the left.
home_url( '/' )). Without a logo it renders as
text using the site name, with the tagline underneath when one is set.2. Logo
Open Site Identity
Appearance → Customize → Site Identity.
Select the logo
Select logo → upload or pick from the media library → Publish. The declared logo area is 96×96 with flexible width and height, so a square-ish logo around that size looks right; a very wide logo will also work but gets scaled down.
Optional: skip cropping
If the crop screen appears, choose Skip Cropping.
has_custom_logo() takes precedence). To go back to the text brand, open Site Identity again
and Remove the logo.3. Favicon (site icon)
Open Site Identity
Appearance → Customize → Site Identity → Site Icon.
Upload a square image
WordPress requires at least 512×512 px; it generates the smaller sizes itself (including the 180×180 touch icon), so a 512×512 PNG is enough.
Publish
Publish, then reload the site.
4. Header navigation (main menu)
Create a menu
Appearance → Menus → give it a name (e.g. Header) → Create Menu.
Add items
Add from the left column — Custom Links (any URL + label), Pages, Categories, Posts — then click Add to Menu.
Order and nest
Drag items to reorder. Drop an item slightly to the right under another one to make it a submenu (a dropdown). One level of nesting matches the intended design.
Assign the location
Under Menu Settings tick Primary Menu — that is the header menu. Tick Footer Menu as well if the same links should also appear in the footer.
Save
Save Menu, then reload the site.
An empty Primary Menu location does not mean an empty navbar. The theme falls back to a
built-in menu: “Home” plus up to 5 categories with the most posts (the default
Uncategorized category is excluded). The limit is the constant
BLOGTAIL_GENERAL_DEFAULT_NAV_ITEMS = 5 in inc/template-tags-nav.php.
Those links are generated by the theme and are not editable in wp-admin — assign your own menu to the Primary Menu location to take control of them.
How the header behaves (verified in the theme’s header.php)
| Behaviour | Detail |
|---|---|
| Layout | One white row: brand · navigation · search + Subscribe |
| Breakpoint | Below 1280px (xl) the navigation, the search icon and the Subscribe button move into the hamburger panel (#menu-toggle); the bar keeps the brand and the burger |
| Submenus | Parent items get a chevron; on large screens a dropdown panel opens, on small screens a toggle button expands it |
| Menu markup | Rendered by the theme’s own Nav_Walker (it adds classes such as blogtail-submenu), so avoid re-styling the menu list unless you need to |
The Subscribe button (also part of the header)
The theme decides the URL itself, in this order:
- If a page with the slug
subscribeexists → the button links to that page. - Otherwise → it links to the site’s RSS feed.
To point it somewhere else without code, create (or trash) that page. Developers can override
it with the blogtail_general_subscribe_url filter.
Verify your changes
| Check | Expected |
|---|---|
| Browser tab | New site title (title-tag builds <title>) |
| Header brand | Logo image, or site name text when no logo is set |
| Favicon | New icon in the tab/bookmarks after a hard reload |
| Header menu | Your menu items, in your order, with dropdowns where you nested them |
| Narrow window (< 1280px) | Menu, search and Subscribe inside the hamburger; brand + burger still visible |
Troubleshooting
| Symptom | Cause / fix |
|---|---|
| Still seeing Home + categories you never added | No menu is assigned to the Primary Menu location — assign yours |
| Menu edits not visible | Right location ticked? Menu saved? Then hard reload (and purge the Cloudflare cache if the site is behind it) |
| Logo does not change | The logo may have been removed again, or the browser/CDN still has the old asset → hard reload / purge |
| Favicon still the old one | Browser and CDN caching — try a private window, then purge |
| Site title unchanged in the tab | An SEO plugin (Yoast, Rank Math, …) can override the title; check its settings |
| Navigation collapsed into the hamburger on desktop | The window is narrower than 1280px — the theme’s header switches below xl |
Notes and gaps
- The theme registers no additional Customizer settings (no header options panel); site name, logo, site icon and menus are all core WordPress screens.
- Not documented yet: whether this site already has a logo/site icon configured, and where the
Subscribe button should point (a
subscribepage, or the RSS feed).