Shopify anchor link lands behind the sticky header? Add scroll margin

[vistabylara-dev]

إذا غطّت الترويسة الثابتة عنوان القسم بعد الانتقال إليه، اترك مسافة تمرير مناسبة.

Free Shopify code series · 45/50 · Reviewed 24 October 2026

The problem

An anchor jump can position its destination under a sticky header. scroll-margin adds space around the target's scroll position without adding visible padding to the layout.

Placement and precautions

Duplicate the theme and work in its unpublished preview. Save the original files and change one component at a time.

Apply the class to your existing anchor destination. If using this example ID, point the corresponding link to that exact section-specific ID. Merge the heading and adjust 6rem to the real sticky-header height. If the file already has a stylesheet tag, merge these CSS rules into that existing tag rather than adding a second one.

Bounded Liquid example — not a replacement for an entire theme file:

<div id="VblAnchor-{{ section.id }}" class="vbl-anchor-target">
  <h2>{{ 'vbl_45.heading' | t }}</h2>
</div>
{% stylesheet %}
  .vbl-anchor-target {
    scroll-margin-block-start: 6rem;
  }
{% endstylesheet %}

Translation keys: Merge this object into the root of the existing locales/en.default.json, keeping all other keys and valid commas. Add corresponding translations to every active language file. Replace generic example wording with accurate store content. Do not replace the entire locale file.

{
  "vbl_45": {
    "heading": "Product details"
  }
}

Check in preview

Test clicking an anchor and loading a direct hash URL on desktop and mobile. Check expanded/mobile headers, browser zoom and keyboard focus location.

Limits to understand

This does not move focus automatically or repair a wrong hash. Responsive headers may require different offsets; custom JavaScript scrolling may need its own adjustment.

Validation: This code and locale JSON passed Shopify's validation tool. This is static validation, not proof of rendering, accessibility, theme compatibility, indexing or improved sales. No live merchant store was changed or purchase performed.

Rollback

Restore the saved markup and styles if anything regresses. Remove any new calls before deleting their referenced files. Remove only unused locale keys introduced for this example. Keep the previous working theme available until the full affected journey has been checked.

Need this fixed in your store?

Send Dr Lara your store URL, theme name, affected page and what changed before the issue started. Start with free guidance and a free initial consultation. If you want implementation, we agree the scope and fee separately before work starts.

Explore Shopify repairs and development with Vista by Lara

WhatsApp Dr Lara about guide 45 or call +971 50 799 4292.

Free guidance. No commitment. Practical implementation is separately scoped.

Join the discussion

What result do you see, and what should happen instead? Share a short sanitized example. Remove passwords, tokens, customer details and private admin URLs.

• Free Shopify help hub
• Follow Dr Lara on GitHub
• Join our LinkedIn group
• Visit Vista by Lara

Official references

• Technical documentation 1

Dr Lara · Vista by Lara · Dubai, UAE