Housecall Pro subcategory mismatch

What this error means

Categories in a Housecall Pro price book can contain subcategories, but they have to be structured consistently. Housecall Pro reports a mismatch when the number of subcategories within a category doesn’t line up — for example when some items in a category are filed under subcategories and others in the same category are not.

Documented causes and resolutions

• Uneven subcategory counts within a category. Make the subcategory structure consistent across the category, or remove the subcategories entirely so every item sits directly under the category.
• An empty category mixing services and subcategories. Within an empty category you can add either services or additional subcategories — but not both.
• Too many nested levels. Housecall Pro recommends keeping to roughly three or four levels, especially if you integrate with QuickBooks; deeper nesting is fragile.

How to fix it, step by step

1. Group your rows by category and look at how subcategories are used within each one.
2. Decide, per category, whether it uses subcategories at all — then apply that choice to every item in the category.
3. If a category is inconsistent, either give every item a subcategory or delete the subcategories so items sit directly under the category.
4. For an empty category, choose services or subcategories, not a mix of both.
5. Keep nesting shallow (about three to four levels) and re-import.

Common mistakes

• Adding a subcategory to only some items in a category and leaving the rest at the top level.
• Deep, many-level hierarchies that look tidy in a spreadsheet but break on import.
• Trying to place both services and subcategories inside the same empty category.

Prevent it next time

Keep each category’s structure uniform and shallow. While ImportFix focuses on file-level problems, running your export through the price book checker first clears the encoding, whitespace, and formatting issues that make a category’s structure look inconsistent when it isn’t. Building fresh from the template makes a consistent structure easier to maintain.

FAQ

What triggers a subcategory mismatch in Housecall Pro?

A mismatch happens when the number of subcategories within a category doesn't line up — typically when some items in a category use subcategories and others don't. Make the structure consistent, or remove the subcategories.

Can a category contain both services and subcategories?

Within an empty category you can add either services or additional subcategories, but not both. Choose one to avoid the mismatch.

Related: all price book import errors.