How to fix this issue CLA, CI theme check

Topic summary

A developer encountered CLA and CI theme check errors when creating a pull request for a Shopify theme.

CLA Issue Resolution:

  • Sign the Contributor License Agreement via the link provided by the CLA bot in PR comments
  • Ensure the correct GitHub account/email is used
  • Re-trigger checks after signing by pushing a new commit or reopening the PR

CI Theme Check Failures:
Typically caused by:

  • Missing or incorrect theme files
  • Linting violations
  • Failed Shopify CLI validation

Recommended Fix Steps:

  1. Review CI logs in the pull request for specific error details
  2. Run shopify theme check locally to identify issues
  3. Address common problems like unused CSS/JS, missing Liquid tags, or syntax errors
  4. Push fixes to re-trigger automated checks

Status: The issue was resolved with the provided guidance, and the original poster confirmed the explanation was helpful.

Summarized with AI on October 28. AI used: claude-sonnet-4-5-20250929.

Is there anyone who know how to fix this issue whenever I create a Pull request for my theme I got this issue

Hi @amisha-29

I am from Mageplaza - Shopify solution expert.

1. CLA (Contributor License Agreement) Issue
This usually occurs when you’re trying to contribute code to an open-source project, and the CLA has not been signed.

How to fix:

  • Check PR comments: If you’re on GitHub, the CLA bot usually leaves a comment with a link to sign the agreement.
  • Sign the CLA: Click the link provided and follow the instructions. If you’re part of an organization, make sure you’re using the correct GitHub account/email.
  • Re-run checks: After signing, you may need to trigger the checks again (close & reopen PR, or push a new commit).

2. CI Theme Check (Shopify or general theme validation)
If you’re working on a Shopify theme or a custom theme repo and see a CI (Continuous Integration) Theme Check failure, it often relates to:

  • Missing or incorrect files (e.g., theme.liquid, schema, etc.)
  • Linting or best practices violations
  • Failing Shopify CLI validation tests

How to fix:

  1. Check CI Logs: In your GitHub pull request or CI tool (e.g., GitHub Actions), expand the failed job to read the logs. Look for lines like:
Theme Check: 2 offenses detected
  1. Run theme check locally:
    If using Shopify CLI:
shopify theme check

If using Ruby gem:

theme-check

3. Fix any errors/warnings based on the report. Common issues include:

  • Unused CSS or JS
  • Missing {{ content_for_header }} or {{ content_for_layout }}
  • Syntax errors in .liquid files

4. Push your fixes to re-trigger CI.

Tips

  • Ensure your Git author email matches your GitHub account (important for CLA bots).
  • If CI errors are vague, ask maintainers for clarification.
  • You can usually find documentation in the repo’s .github folder or CONTRIBUTING.md.

Please let me know if it works as expected!

Best regards

1 Like

Thankyou for this detailed explanation

1 Like