MagicDX

Theme

Magic-Mark — Troubleshooting ​

Magic-Mark button missing from Content Manager toolbar ​

  1. Verify plugin is enabled and you've run npm run build && npm run develop.
  2. Clear cache: rm -rf .cache dist node_modules/.cache.
  3. Check collectionsAllowlist / collectionsBlocklist in config — this collection may be excluded.
  4. Verify your admin user has find permission on the collection.

Shared bookmarks not visible to recipients ​

Check each item:

  1. Recipient has the correct role (Admin → Users → Edit).
  2. Role name matches exactly (Strapi role names are case-sensitive).
  3. Visibility is not Private (right-click bookmark → Share → check mode).
  4. Recipient has find permission on the collection — even shared bookmarks require base permissions.
  5. Ask recipient to refresh — bookmark sidebar caches for 60 seconds.

Bookmark filter broken after schema change ​

Symptoms: clicking the bookmark shows no results or an error like "Field foobar does not exist."

Cause: a field in the saved query was renamed or deleted.

Fix:

  1. Open the bookmark — a warning icon appears next to broken filters.
  2. Right-click → Edit.
  3. Re-save — the editor will strip invalid filters automatically.

Or bulk-fix via the Advanced API:

typescript
const service = strapi.plugin('magic-mark').service('bookmarks');
await service.cleanInvalidFilters('api::article.article');  // removes orphaned filter fields

Bookmark limit reached error ​

Error: LIMIT_REACHED — you have 10/10 bookmarks (Free tier)

Options:

  • Delete unused bookmarks.
  • Upgrade to Premium (50) or Advanced (unlimited).
  • As admin, increase global limit: config.maxBookmarksPerUser overrides tier defaults (though license restrictions still apply).

Import fails ​

Error: Cannot import — version mismatch (file: 1.0, current: 1.2)

Happens when importing a bookmark JSON from a different plugin version. Options:

  • Upgrade the target Strapi to the same plugin version.
  • Manually fix the import JSON (version field + any renamed properties).
  • Export from the current instance, compare structures, translate.

Query history empty ​

  • Query history is Premium / Advanced only.
  • Verify license tier in admin → Magic-Mark → License.
  • Verify enableHistory: true in config.
  • History table is magic_mark_query_history — check it exists in the database.

Drag and drop not working ​

  • Plugin version must be ≥ 1.1 (earlier versions had a known issue with drag handles).
  • Browser: Chrome/Firefox/Edge work; Safari sometimes fails — try refreshing.
  • Check browser console for drag-drop JS errors.

Collection missing from bookmark creation dialog ​

Happens when:

  • Collection was created AFTER the bookmark plugin loaded. Restart Strapi.
  • collectionsAllowlist is set and doesn't include this collection.
  • User doesn't have permission on the collection.

Bookmark shows for one user but not another in the same role ​

Confirm:

  1. Both users are in the role (Users → Edit → Roles).
  2. Both users have base permissions on the collection.
  3. Ask the affected user to log out and back in (role changes don't propagate instantly).
  4. Check audit log for sharing changes.

Query exports as null in API response ​

The bookmark is stored but the query field is empty. Causes:

  • Bookmark was created with the Apply-without-save quickbar feature. Re-open and save.
  • Database corruption — restore from backup.

Slow bookmark application ​

Large result sets can be slow to render. Fixes:

  • Reduce pageSize in the saved query.
  • Add a more selective filter (e.g. publishedAt>=last-month).
  • Index the filtered fields in your database for faster queries.

Enable debug mode ​

bash
DEBUG=magic-mark:* npm run develop

Still stuck? ​