Troubleshooting

Migration issues

Always use the --dry-run flag first to preview changes. Use --backup to create a database backup before migrating. If migration fails partway through, restore from the backup and try again.

Element link returns nothing

Element links resolve their target automatically on access (e.g. {{ entry.myLink.element.title }}). Do not pass a FreeLink field handle to .with([...]) — FreeLink fields are not eager-loadable, and doing so replaces the LinkCollection value with an empty result. Remove the field handle from .with() and access the link directly instead.

Getting Help

If you encounter issues, please open an issue on GitHub.