GitHub theme integration text issue

Retired Boards Appdev Partners Discussion

Topic summary

A developer is experiencing a validation error with GitHub theme integration that doesn’t occur during local CLI development. The error message states: Setting 'summary_text' is invalid. All top level nodes must be '<p>' tags.

Current Setup:

  • Alternative product template (product.alt.json) contains a summary text block
  • Block schema defines a text-type setting with ID summary_text
  • Template renders the text within <h4> tags

The Problem:

  • Theme works perfectly locally and is live without errors
  • After merging updates from live theme into development version, GitHub integration throws validation error
  • Error specifically requires all top-level nodes to be <p> tags, but the implementation uses <h4> tags

Status: The developer is seeking help from anyone who has encountered similar issues with Shopify themes connected through GitHub integration, as the discrepancy between local/live functionality and GitHub validation is unclear.

Summarized with AI on November 25. AI used: claude-sonnet-4-5-20250929.
1

We have a theme that is live and no errors. Downloaded an update to the theme, merged changes from live into this, all works well when developing it locally using the CLI. Files are all in the GIT repo, but the GitHub integration theme log displays an error that makes no sense:

Error: templates/product.alt.json, Validation failed: Setting 'summary_text' is invalid. All top level nodes must be '<p>' tags, Invalid value for type in block '9c7d3801-6516-4da3-9377-14087a4da194'. Type must be defined in schema.

This is an alternative product template with text to display for that template. The schema is set up like this:

{
        "name": "Summary text",
        "type": "product-summary",
        "settings": [
          {
            "type": "text",
            "id": "summary_text",
            "label": "Product Summary Text",
            "default": "Default content"
          }
        ]
      },

Block set up here, as you can see, it’s text within an h4 tag:

 {%- when 'product-summary' -%}
  <div class="product-summary">
   <h4>{{ block.settings.summary_text }}</h4>
  </div>

Anyone able to help or has had issue with a theme developed and connected to Shopify through Github?