Skip to main content

​
What is Content Health?

Kinship’s Content Health feature is designed to automatically flag common issues in your Revit families — before those issues cause performance problems, disrupt workflows, or break your standards. It works quietly in the background, checking for things like corrupt files, invisible geometry, naming problems, broken lookup tables, and more. The goal is simple: help your team avoid frustration and wasted time by catching issues early, without needing to open each family in the Revit editor. These checks run across your Library, Collections, and Projects, giving you visibility into both curated and in-use content.

​
Where do checks run and where do I see results?

You’ll see health check results in a few key places:
  • Content Health section on the Library landing page
    An at-a-glance panel highlights the top five issues most prevalent across families that are actually in use in your active projects. Select See more to open a full breakdown by check. The list shows two helpful counts for each check:
    1. Families affected — how many families in your library have the issue, and
    2. Placed instances — how many instances of those families are placed across projects.
    Use these numbers to prioritize fixes toward high-impact items. Clicking any check opens a filtered list of the affected families. From there, you can open the family in Revit directly from the web app, make the fix, and overwrite it back into Kinship; the system then re-checks the file automatically.
  • Tracked Project content
    Kinship flags problematic families inside project models as well.
  • Family summary pages
    Each issue is listed in detail so you can understand what was found.
You can also filter any content listing to show only families that have issues. The Library page includes a dedicated list of families with problems to focus your cleanup efforts.

​
How the checks work

Kinship runs 26 automated checks, organized into helpful categories like:
  • Corrupt Families
  • Geometry & Views
  • Hosting
  • Kinship Errors
  • Lookup Tables
  • Naming
  • Parameters
  • Revit Errors
  • Type Catalogs
You can enable or disable individual checks depending on your needs, but you cannot write custom checks.
See Parameter Data Reports for ways to validate and audit your models.
When you update a family (for example, by fixing it in Revit and re-uploading it), Kinship automatically re-checks it. If the problem is resolved, the issue disappears on its own, no manual cleanup needed.

​
Why these categories matter

Understanding the types of issues Kinship checks for can help you make better decisions about what to fix and why.
  • Corrupt or unstable families pose a real risk to project stability. These are the ones that might crash Revit or fail to load properly.
  • Geometry and view issues can result in invisible content, bloated file sizes, or confusing user experience — especially if someone loads a family and nothing appears in 3D.
  • Hosting problems often show up later, when families don’t place correctly or shift unexpectedly in models.
  • Lookup tables and type catalogs are crucial for properly defining types and controlling how families behave when loaded into a project.
  • Naming and parameter hygiene might not crash your model, but they can seriously affect your ability to search, tag, and schedule content — and they’re easy to overlook without tools like this.
For a full list of checks and what each one does, see the reference page for Content Health checks.

​
How to prioritize what to fix

Not every issue is equally urgent. Here are a few simple ways to decide where to start:
  • Fix the big problems first
    Corrupt families or ones that crash Revit should always be a priority.
  • Focus on families that get used a lot
    Even small issues become big headaches if they’re on content that shows up in dozens of projects.
  • Tackle low-hanging fruit
    Naming issues, missing default types, or embedded images are often quick wins that improve usability across the board.
It can help to think in terms of impact × frequency. A small issue on a highly-used family might be more important than a rare crash on something nobody uses.

​
Where this fits in your workflow

There are two great times to use Content Health:
  1. When reviewing content before adding it to the Library
    This helps you catch problems early and avoid promoting bad content.
  2. When monitoring content inside projects
    You can see when problematic families make their way into live models — and address them before they cause downstream issues.
For teams on an Enterprise plan, you can also combine Content Health with Parameter Reports to run deeper, custom checks (like verifying Uniclass codes or required fields).

​
What happens when you fix a family?

When you edit a family in Revit and re-upload or overwrite it in Kinship, the system:
  • Automatically re-evaluates the file
  • Removes any resolved issues
  • Keeps only the current, accurate list of problems (if any)
There’s nothing extra you need to do — just make the fix and update the file.

​
What Content Health does (and doesn’t do)

This feature is focused on Revit families and their structure, not the full model. It doesn’t replace Revit warnings or Kinship’s broader model tracking — it complements them. And while it gives you a lot of insight, it doesn’t let you write your own checks inside the system. For more advanced or custom audits, look to Parameter Reports or external validation workflows.

​
Want to go deeper?