Shopify themes, liquid, logos, and UX
Hello everyone,
When I did site audit I get this error < Heading Tags: Heading 1 missing on page > I don't have enough coding experience but I tried to fix it but it is still same error, Please how can I do that ?!
Solved! Go to the solution
This is an accepted solution.
Hello @ashraf-sl, I have checked your home page elements. On the home page, there is no "<h1>" tag found when I checked. Please put a header with one "<h1>" tag in your slider or some main section. Then please check if an audit is passed or not. You have to put a compulsory "<h1>" if you use some other tags of the headings like "h2, h3...h6".
If I helped you then, don't forget to Like it and Mark it as a Solution!
Best Regards,
Darshan Prajapati
Hi @ashraf-sl,
Please send me the code of header.liquid file, I will check and add it for you
This is an accepted solution.
Hello @ashraf-sl, I have checked your home page elements. On the home page, there is no "<h1>" tag found when I checked. Please put a header with one "<h1>" tag in your slider or some main section. Then please check if an audit is passed or not. You have to put a compulsory "<h1>" if you use some other tags of the headings like "h2, h3...h6".
If I helped you then, don't forget to Like it and Mark it as a Solution!
Best Regards,
Darshan Prajapati
Thank you for your assist
What I did? I added custom liquid section to main page. to fix the issue temporary right now.
<h1>text</h1>
Hi @ashraf-sl,
You can refer https://github.com/Shopify/dawn/blob/main/sections/header.liquid
You can refer to the following code: https://prnt.sc/X1GJMAln_DaW
Hello Namphan, I have the same issue. I am using Stiletto as theme template.
Can you please adjust my code so that i get H1 tags ? As of now, I can only create H2,h3,h4,h5,h6. Thank you! Our shop is maisongiulia.myshopify.com
Hi @maisongiulia,
I checked and your home page already includes the h1 tag, did you add it?
Hi Namphan! Thanks so much for your response. Indeed, in the code "Savour the Mediterranean sprit-free" is H1 on the home page, but in my shopify tool, it shows h2-h6, without any of them clicked.
Which takes me to the issue that on other pages the heading are selected as H2, because H1 option is not available.
https://maison-giulia.com/pages/founders-note
https://maison-giulia.com/pages/our-values
https://maison-giulia.com/pages/our-terroir
Hi @maisongiulia,
Please send me the code of theme.liquid file, I will check and guide it for you
here you go! Thanks so much Namphan
<!doctype html>
<!--
___ ___ ___ ___
/ /\ /__/\ / /\ / /\
/ /:/_ \ \:\ / /:/ / /::\
/ /:/ /\ ___ ___ \ \:\ / /:/ / /:/\:\
/ /:/ /:/ /__/\ / /\ ___ \ \:\ / /:/ ___ / /:/ \:\
/__/:/ /:/ \ \:\ / /:/ /__/\ \__\:\ /__/:/ / /\ /__/:/ \__\:\
\ \:\/:/ \ \:\ /:/ \ \:\ / /:/ \ \:\ / /:/ \ \:\ / /:/
\ \::/ \ \:\/:/ \ \:\ /:/ \ \:\ /:/ \ \:\ /:/
\ \:\ \ \::/ \ \:\/:/ \ \:\/:/ \ \:\/:/
\ \:\ \__\/ \ \::/ \ \::/ \ \::/
\__\/ \__\/ \__\/ \__\/
--------------------------------------------------------------------
# Stiletto v3.2.1
# Documentation: https://fluorescent.co/help/stiletto/
# Purchase: https://themes.shopify.com/themes/stiletto/
# A product by Fluorescent: https://fluorescent.co/
--------------------------------------------------------------------
-->
<html class="no-js" lang="{{ request.locale.iso_code }}" style="--announcement-height: 1px;">
<head>
<meta name="google-site-verification" content="g0blwcUuvOs70mlwD5TV9HbTqKutCcKmQ3NsvwvflKU" />
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width,initial-scale=1">
{% render 'meta-description' %}
<link rel="canonical" href="{{ canonical_url }}">
<link rel="preconnect" href="https://cdn.shopify.com" crossorigin>
{%- if settings.favicon != blank -%}
<link rel="shortcut icon" href="{{ settings.favicon | image_url: width: 32, height: 32 }}" type="image/png">
{%- endif -%}
{%- capture seo_title -%}
{%- if request.page_type == 'search' and search.performed == true -%}
{{ 'search.heading' | t: count: search.results_count }}:
{{ 'search.results_with_count' | t: terms: search.terms, count: search.results_count }}
{%- else -%}
{{ page_title }}
{%- endif -%}
{%- if current_tags -%}
{%- assign meta_tags = current_tags | join: ', ' -%}
– {{ 'general.meta.tags' | t: tags: meta_tags -}}
{%- endif -%}
{%- if current_page != 1 -%}
– {{ 'general.meta.page' | t: page: current_page }}
{%- endif -%}
{%- assign escaped_page_title = page_title | escape -%}
{%- unless escaped_page_title contains shop.name -%}
– {{ shop.name }}
{%- endunless -%}
{%- endcapture -%}
<title>{{ seo_title | strip }}</title>
{% render 'social-meta-tags' %}
{% render 'theme-setup' %}
{% render 'theme-setting-vars' %}
{%- render 'theme-globals' -%}
{{ content_for_header }}
</head>
<body class="template-{{ request.page_type | handle }}">
<div class="page">
{% if settings.enable_page_transitions %}
{% render 'page-transition-overlay' %}
{% endif %}
<div class="theme-editor-scroll-offset"></div>
<div class="header__space" data-header-space></div>
{% sections 'header-group' %}
{% sections 'overlay-group' %}
{%- if settings.enable_quick_search -%}
{% render 'quick-search' %}
{%- endif -%}
<div class="header-overlay" data-header-overlay>
<div class="header-overlay__inner"></div>
</div>
<main id="main" class="main">
{{ content_for_layout }}
</main>
{% sections 'footer-group' %}
{% render 'store-availability-drawer' %}
{% render 'quick-view-modal' %}
{% render 'modal' %}
{% render 'back-to-top' %}
</div>
{{ '//www.youtube.com/iframe_api' | script_tag }}
{{ '//cdn.shopify.com/shopifycloud/shopify-plyr/v1.0/shopify-plyr.css' | stylesheet_tag }}
</body>
<link
rel="preload"
fetchpriority="low"
href="{{ 'theme-deferred.css' | asset_url }}"
as="style"
onload="this.onload=null;this.rel='stylesheet'"
>
<noscript><link rel="stylesheet" href="{{ 'theme-deferred.css' | asset_url }}"></noscript>
</html>
Hi @maisongiulia,
Please change all code:
<!doctype html>
<!--
___ ___ ___ ___
/ /\ /__/\ / /\ / /\
/ /:/_ \ \:\ / /:/ / /::\
/ /:/ /\ ___ ___ \ \:\ / /:/ / /:/\:\
/ /:/ /:/ /__/\ / /\ ___ \ \:\ / /:/ ___ / /:/ \:\
/__/:/ /:/ \ \:\ / /:/ /__/\ \__\:\ /__/:/ / /\ /__/:/ \__\:\
\ \:\/:/ \ \:\ /:/ \ \:\ / /:/ \ \:\ / /:/ \ \:\ / /:/
\ \::/ \ \:\/:/ \ \:\ /:/ \ \:\ /:/ \ \:\ /:/
\ \:\ \ \::/ \ \:\/:/ \ \:\/:/ \ \:\/:/
\ \:\ \__\/ \ \::/ \ \::/ \ \::/
\__\/ \__\/ \__\/ \__\/
--------------------------------------------------------------------
# Stiletto v3.2.1
# Documentation: https://fluorescent.co/help/stiletto/
# Purchase: https://themes.shopify.com/themes/stiletto/
# A product by Fluorescent: https://fluorescent.co/
--------------------------------------------------------------------
-->
<html class="no-js" lang="{{ request.locale.iso_code }}" style="--announcement-height: 1px;">
<head>
<meta name="google-site-verification" content="g0blwcUuvOs70mlwD5TV9HbTqKutCcKmQ3NsvwvflKU" />
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width,initial-scale=1">
{% render 'meta-description' %}
<link rel="canonical" href="{{ canonical_url }}">
<link rel="preconnect" href="https://cdn.shopify.com" crossorigin>
{%- if settings.favicon != blank -%}
<link rel="shortcut icon" href="{{ settings.favicon | image_url: width: 32, height: 32 }}" type="image/png">
{%- endif -%}
{%- capture seo_title -%}
{%- if request.page_type == 'search' and search.performed == true -%}
{{ 'search.heading' | t: count: search.results_count }}:
{{ 'search.results_with_count' | t: terms: search.terms, count: search.results_count }}
{%- else -%}
{{ page_title }}
{%- endif -%}
{%- if current_tags -%}
{%- assign meta_tags = current_tags | join: ', ' -%}
– {{ 'general.meta.tags' | t: tags: meta_tags -}}
{%- endif -%}
{%- if current_page != 1 -%}
– {{ 'general.meta.page' | t: page: current_page }}
{%- endif -%}
{%- assign escaped_page_title = page_title | escape -%}
{%- unless escaped_page_title contains shop.name -%}
– {{ shop.name }}
{%- endunless -%}
{%- endcapture -%}
<title>{{ seo_title | strip }}</title>
{% render 'social-meta-tags' %}
{% render 'theme-setup' %}
{% render 'theme-setting-vars' %}
{%- render 'theme-globals' -%}
{{ content_for_header }}
</head>
<body class="template-{{ request.page_type | handle }}">
{%- if request.page_type == 'page' -%}
<h1 style="display: none">{{ page.title }}</h1>
{%- endif -%}
<div class="page">
{% if settings.enable_page_transitions %}
{% render 'page-transition-overlay' %}
{% endif %}
<div class="theme-editor-scroll-offset"></div>
<div class="header__space" data-header-space></div>
{% sections 'header-group' %}
{% sections 'overlay-group' %}
{%- if settings.enable_quick_search -%}
{% render 'quick-search' %}
{%- endif -%}
<div class="header-overlay" data-header-overlay>
<div class="header-overlay__inner"></div>
</div>
<main id="main" class="main">
{{ content_for_layout }}
</main>
{% sections 'footer-group' %}
{% render 'store-availability-drawer' %}
{% render 'quick-view-modal' %}
{% render 'modal' %}
{% render 'back-to-top' %}
</div>
{{ '//www.youtube.com/iframe_api' | script_tag }}
{{ '//cdn.shopify.com/shopifycloud/shopify-plyr/v1.0/shopify-plyr.css' | stylesheet_tag }}
</body>
<link
rel="preload"
fetchpriority="low"
href="{{ 'theme-deferred.css' | asset_url }}"
as="style"
onload="this.onload=null;this.rel='stylesheet'"
>
<noscript><link rel="stylesheet" href="{{ 'theme-deferred.css' | asset_url }}"></noscript>
</html>
Thank you Namphan. Does it mean that every time i put a H2, the SEO reads it as H1?
I also found a way to put H1 through choosing option "Text". Do you suggest I use this for our titles or should I go with section "Heading" and choose H2?
Hi @maisongiulia,
I have helped you add default H1 for all pages according to page title.
About the screenshot, you can try to change it and send me the link, I will check it
Hi Namphan, I now have this weird text showing up instead of H2 in the options menu of the title. Would you agree that instead of using the Title section, I use the text section and use H1 for titles?
Hi @maisongiulia,
Looks like this should work, can you try it?
Learn how to build powerful custom workflows in Shopify Flow with expert guidance from ...
By Jacqui May 7, 2025Did You Know? May is named after Maia, the Roman goddess of growth and flourishing! ...
By JasonH May 2, 2025Discover opportunities to improve SEO with new guidance available from Shopify’s growth...
By Jacqui May 1, 2025