"Warning: .shopifyignore was ignored" in GitHub integration theme logs

Online Store and Theme Development
1

Short description of issue

.shopifyignore is not respected when a theme repository is connected via Shopify’s GitHub integration. The file is ignored and a warning appears in the theme logs.

Reproduction steps

  1. Create a theme repository on GitHub.
  2. Connect the repository to a Shopify store via Online Store → Themes → Import theme → Connect from GitHub.
  3. Add a .shopifyignore file to the root of the theme.
  4. Commit and push the file to the remote GitHub repository.
  5. In Online Store → Themes, wait for the theme to sync with the latest push.
  6. Click View logs.
  7. Observe the warning: Warning: .shopifyignore was ignored.

Additional info

When integrating a GitHub theme repository with Shopify, the .shopifyignore file is ignored and a warning appears in the theme logs, as shown in the attached screenshot.

For reference, see the Shopify CLI documentation for themes regarding .shopifyignore.

What type of topic is this

Bug report

Upload screenshot(s) of issue

Screenshot 2026-03-04 at 14.32.24.png
Screenshot 2026-03-04 at 14.32.24.png1054×534 45.4 KB

2

It’s “technically” the correct behaviour because .shopifyignore is not part of the theme structure but instead used for local development only, i.e. it wouldn’t ever be uploaded to the store.

This will only ever show on your initial commit or when you change the ignore file. .shopifyignore is more-so meant for CLI commands, rather than the Github Integration.

But yes perhaps it shouldn’t produce a warning for this file, but simply do nothing :person_shrugging:

3

Ahh I see, that makes sense. I rarely use the Shopify CLI push and pull workflow, so I didn’t really consider that .shopifyignore is mainly intended for that setup.

That said, it would make sense for it to be supported at the theme architecture level, similar to how .gitignore is honored by web-based Git platforms, so it better aligns with developer expectations.