---
url: https://laranex.vercel.app/laravel-schema-viewer/hints.md
description: Where the database and the models disagree, and how to act on each hint.
---

# Hints

Hints point at places where the database and the models disagree. They are informational: the Hints tab lists them, the table card shows a count, and `schema-viewer:check` can fail your CI on the kinds you choose. Framework tables never get hints.

| Kind | Meaning | Usual fix |
|---|---|---|
| `relation_without_foreign_key` | A relation uses columns with no foreign key, so rows can point at deleted ones | Add a foreign key in a migration, or ignore it when intended |
| `foreign_key_without_relation` | A foreign key that no model declares | Add the `belongsTo` / `hasMany` pair |
| `foreign_key_without_index` | A foreign key column with no index that starts with it (PostgreSQL, SQLite and SQL Server do not add one) | Add an index |
| `model_without_table` | A model whose table does not exist on its connection | Run the migration, or fix `$table` / `$connection` |
| `morph_without_map` | Morph columns store class names such as `App\Models\Post`, so renaming a model breaks rows | Register `Relation::enforceMorphMap()` |
| `unresolved_relation` | A relation method threw when called | Fix the method |

Polymorphic relations and relations across connections cannot have a foreign key, so they never get `relation_without_foreign_key`.

## Ignoring hints

Accept a hint for good in `config/schema-viewer.php`, by kind or for one table:

```php
'hints' => [
    'ignore' => ['morph_without_map', 'relation_without_foreign_key:audit_logs'],
],
```