How Quality Score Settings Work¶
DO Calculating quality scores
Quality score settings control how a score is calculated: how far back in time it looks, and how much each dimension and each container counts. Settings are defined on the datastore and can be overridden for individual containers. To change them, follow Quality Score Settings.
Settings Inheritance and Overrides¶
Datastore quality score settings define the decay period and dimension weights for the datastore score. They also act as the default for containers that do not have their own quality score settings. A container (table, file, computed table, computed file, or computed join) can override that inherited configuration with its own settings.
This means:
- Unconfigured containers inherit datastore settings: Changing the datastore decay period or dimension weights affects containers that do not have an override.
- Container overrides are local: Changing a container's settings affects that container, but it does not change the datastore settings or other containers.
- System defaults apply first: Until the datastore is configured, its score and containers without overrides use the system defaults (180-day decay, all dimensions at weight 1.0).
- Use overrides for exceptions: Configure the datastore once for the common policy, then add container settings only where the data needs a different decay period or dimension weighting.
graph TD
DS["<b>Datastore Settings</b><br/>Decay: 90 days, Accuracy: 1.5"] --> DS_SCORE["Datastore Score<br/>(weighted avg of container scores)"]
DS --> C1_SCORE["Container A Score<br/>(inherits datastore settings)"]
C2["<b>Container B Override</b><br/>Decay: 30 days, Timeliness: 0"] --> C2_SCORE["Container B Score"]
C1_SCORE --> DS_SCORE
C2_SCORE --> DS_SCORE
In this example, the datastore uses a 90-day decay with a higher Accuracy weight. Container A inherits that configuration because it has no override. Container B uses its own 30-day decay with Timeliness disabled. Both container scores still contribute to the datastore's weighted average.
Decay Period¶
The decay period controls how far back in time Qualytics looks when calculating scores. By default, only anomalies, profiles, and scans from the last 180 days are included.
The decay period can be set from 7 to 180 days, with a default of 180 days.
This means:
- Old issues naturally age out: If an anomaly was detected 6 months ago and has not recurred, it no longer impacts the score.
- Recent issues weigh fully: Any anomaly within the decay window is fully counted.
- Shorter window (for example, 7 days): Focuses the score on recent quality activity. Use it when recent changes matter most.
- Longer window (for example, 180 days): Provides a broader historical perspective for trend analysis.
Dimension Weights¶
Each of the 8 dimensions has a configurable weight that controls its impact on the total container score:
- A weight of 1.0 (default) gives the dimension its full impact.
- A weight of 0 excludes the dimension from scoring: it is treated as fully healthy and cannot pull the score down.
- Weights between 0 and 1 proportionally reduce the dimension's influence.
Weights can be set from 0 to 2.0 (in 0.1 increments), with a default of 1.0.
This allows you to align the scoring system with your organization's data governance priorities. For example, if timeliness is critical for your use case, increase its weight. If volumetrics is less relevant, reduce it.
Use Caution When Customizing Weights
The default weights and decay period reflect the scoring practices Qualytics has refined with enterprises across many sizes and sectors, and we recommend keeping them unless governance priorities clearly justify changes.
- Adjusting weights can significantly alter how anomalies impact overall scores.
- Misaligned weights may cause misleading signals about data quality.
Proceed carefully, and document any custom weighting rationale.
Disabling a Dimension
Setting a dimension weight to 0 excludes it from scoring. The dimension turns grey in the settings UI and is treated as fully healthy, so it cannot pull the container or datastore score down. This is useful when a dimension is not relevant to your data (for example, Timeliness for a static reference table).
Tag Weight Modifiers¶
A tag can carry a weight modifier (-10 to 10). Each container's weight in the datastore score comes from the sum of the modifiers of the tags on that container, so containers with higher tag weights have more impact on the datastore-level quality score. See How Tags Affect the Datastore Score for the aggregate formula.
When weights are recalculated
Container weights are recalculated in two cases: when tags are added to or removed from the datastore, and when you use Move to, Merge, or Remove on a tag's page (Move a Tag to Another Tag, Merge Tags, Remove a Tag from Assets). Both update the weights of the affected containers and the datastore score right away. Assigning a tag directly to a container does not change its weight until one of those happens, so until then the datastore score keeps the previous weights.
Tags and Weighting
For more on how tags influence quality scores, see the Tags Introduction page. For details on the weight calculation formula, see How Tag Weights Affect Quality Scores.
See Also¶
-
Interpreting Scores
See where scores appear, how they support decisions, and how to read them as a measure of fitness for purpose.
-
AI Explanations
Learn how the AgentQ-powered summary, per-dimension explanations, and Recommendations section render on the Quality Score panel.
-
Examples
Walk through real scenarios: a container held down by two dimensions, a datastore score lower than expected, weighting critical tables, and a settings override.
-
Best Practices
Keep scores meaningful: what to profile and scan, how many checks to add, when to change settings, and how to read the trend.
-
Troubleshooting
Resolve missing scores, unexpectedly low values, settings and tag changes that do not apply, and missing AI explanations.
-
Permissions
See which roles can view quality scores and edit scoring settings.
-
How It Works
Learn what the quality score is, the key concepts behind it, the levels it is calculated at, the 8 dimensions it combines, and what triggers a recalculation.
-
Rule Types by Dimension
Look up which rule types feed the Conformity, Precision, Accuracy, Volumetrics, and Timeliness dimensions, with a link to each one.
-
Datastore-Level Scoring
See how container scores roll up into the datastore score, how tags change each container's weight, and how daily history is built.
-
Container-Level Scoring
Learn which containers get a score, how the 70-point baseline model combines the 8 dimensions, and how timeliness and volumetrics are measured.
-
Field-Level Scoring
See how each field is scored on completeness, coverage, conformity, consistency, precision, and accuracy, with the formula behind each dimension.