What is a blank Shopify theme, and which one should I start from?

A blank Shopify theme is a starter codebase: the folders, templates and layout file a theme needs to work, with almost no design, so a developer can build their own on top. Shopify's official blank theme is called Skeleton, and it is what shopify theme init downloads by default.

Be careful with it this month. Skeleton was rewritten on 1 October 2026, and when we pushed the current version to a Shopify development store on 10 October 2026, Shopify rejected 13 of its files with Liquid syntax error (line 1): Unknown tag 'block'. The February 2026 version uploaded with zero errors. If you are a store owner rather than a developer, you do not want a blank theme at all; you want a finished free one.

What is actually inside a blank Shopify theme?

Only the parts Shopify requires to render a store: a layout file that wraps every page, one template per page type (home, product, collection, cart, search, blog, article, page, 404, password, gift card), a settings file, a translation file and a little CSS. There are no designed sections, no product cards worth keeping, and the home page is a placeholder. Skeleton's says hello and links to Shopify's developer documentation.

That is the point of it. A full free theme like Dawn ships 345 theme files and Horizon ships 481, and a developer who wants their own design ends up deleting most of them. Skeleton's February 2026 version had 43.

Which blank or starter themes can I choose from?

We counted the theme files (assets, blocks, config, layout, locales, sections, snippets and templates) in each repository on Shopify's GitHub on 10 October 2026, and pushed both Skeleton versions to a real store.

Dawn and Horizon are not blank themes, but they are the two most common starting points developers fork, and Shopify keeps both maintained: Dawn's repository was updated on 9 October 2026 and Horizon's on 21 September 2026.

Why does Shopify's Skeleton theme fail with "Unknown tag 'block'"?

Because the current version is written in a syntax our store did not accept. The 1 October 2026 commit is titled "Port rc-v2.0.0 with updated block composition syntax", and its README says the theme "deliberately excludes the section-based model": no sections folder, no JSON templates, and every page built by calling blocks directly from a Liquid template, like this home page:

{% block 'container' %}
  {% block 'hello-world' %}
    ...
  {% endblock %}
{% endblock %}

We cloned it, ran shopify theme push --unpublished with Shopify CLI 3.93.1, and the push finished with the warning "pushed with errors". These are the exact messages:

With the layout and every template rejected, there is nothing left to preview. The trap is that shopify theme check does not warn you: on the same files it reported 0 errors and 3 warnings, all Unknown object 'content' used. A clean theme check does not mean Shopify will accept the upload, which is the same lesson as why a Shopify theme ZIP will not upload.

Shopify may well switch this syntax on for every store later; the branch name says release candidate. As of 10 October 2026, on our development store, it was not recognised.

How do I get a Skeleton theme that uploads?

Clone the repository and step back to the last version that still uses sections:

git clone https://github.com/Shopify/skeleton-theme.git my-theme
cd my-theme
git checkout a4f32d3

That is the 26 February 2026 commit, the last one before the rewrite. It has 43 theme files, 14 section files plus header and footer group files, and 11 JSON templates, and our push of it reported "Theme upload complete" with no errors. The older tagged release, v1.0.0 from 20 May 2025, is also section based.

The obvious shortcut does not work. shopify theme init my-theme --latest is meant to download the latest tagged release instead of the newest commit, but on CLI 3.93.1 it stopped with:

Error cloning the repository. Git can't clone the latest release with the 'shallow' property.

So plain shopify theme init gives you the version that does not upload, and --latest gives you an error. Cloning with Git and checking out the commit is the reliable route this month.

Should a store owner start from a blank theme?

No. A blank theme is a starting point for writing code, and it looks like one: a placeholder home page, an unstyled product form, and no sections you can rearrange in the theme editor. If you install one on a live store, your customers see that.

If you want something free and finished, pick one of Shopify's 24 free themes; we compared all of them in the best free Shopify themes and what they leave out. If you want a store that already looks like your brand, every theme in the Themr gallery is free, built with sections you can edit in the Shopify theme editor, and installs as a normal ZIP upload. Switching later does not touch your products or orders, as changing your Shopify theme explains.

Where these numbers come from

On 10 October 2026 we cloned github.com/Shopify/skeleton-theme at its newest commit (a7a655e, 1 October 2026) and at commit a4f32d3 (26 February 2026), pushed each to a Shopify development store as an unpublished theme with Shopify CLI 3.93.1, recorded the output, and deleted both themes. We also ran shopify theme init with and without --latest on the same CLI. File, section, block and template counts for Dawn and Horizon come from the file trees of github.com/Shopify/dawn and github.com/Shopify/horizon read the same day. We make free Shopify themes and sell an AI designed store, so weigh our recommendation of our own gallery accordingly.