Docs Menu

Docs

How To Issue And Return Library Items

Manage library circulation from the Issues & Returns workspace by filtering issues, creating new issue records, and reviewing return, renew, lost, or damaged actions.

Search docs

Search by workflow, module name, or operational keyword.

Documentation search is ready.

Last updated: March 16, 2026

This guide explains how to work in the Issues & Returns workspace to track active library circulation and open the issue form for new loans.

Short summary

The library circulation screen combines search and status filters, a detailed issues table, a guided Create Issue modal, and an issue detail drawer for renew, return, lost, and damaged follow-up actions.

Best for

Librarians and operations staff handling book loans, returns, renewals, and circulation exceptions.

Requires

Access to Library → Issues and permission to issue and manage library loans.

Result

Library issues can be created, tracked, and reviewed from one workspace with status-based follow-up actions.

Before you start

  • Confirm the member already has a valid library card.
  • Confirm the selected book still has available circulation quantity.
  • Decide the due date and any fine rule you want applied to the issue.

Library -> Issues

Step 1: Open Issues & Returns

Go to Library in the sidebar and open Issues.

Library Issues and Returns workspace showing filters, issue records, and action buttons.
Issues & Returns workspace with circulation filters and row-level actions.

Step 2: Filter existing circulation records

Use the top controls to narrow the issue list:

  1. Search book or member
  2. All members
  3. All status
  4. Refresh

This helps you review issued, overdue, returned, lost, or damaged records before creating a new issue or processing a return.

Step 3: Start a new issue

Click Issue book.

Create Issue modal with member, book, due date, and fine rule fields.
Create Issue modal with three stages: member, book, and due-date policy.

The issue form exposes three stages:

  1. Select member
  2. Choose book
  3. Set due & policy

Step 4: Complete the issue form

Fill the available fields:

  • Search card or member
  • Select member
  • Search title / ISBN
  • Select book
  • Due date
  • Fine rule

Review the policy summary at the bottom of the modal before clicking Issue.

Step 5: Review issue details and follow-up actions

From the issue table, click a book title to open the issue detail drawer.

Issue detail drawer showing timeline, fine rule, and return or renew actions.
Issue detail drawer with timeline, policy summary, and return-state actions.

From this drawer you can review:

  • issue status
  • renewal count
  • issue and due dates
  • timeline entries
  • fine-rule details
  • Renew
  • Return
  • Mark lost
  • Mark damaged

Step 6: Verify the circulation state

After issuing or updating an item:

  1. Return to the main table.
  2. Confirm the record appears with the correct member, due date, and status.
  3. Reapply filters if you need to inspect only issued, returned, overdue, lost, or damaged items.

Important notes

Important: lost and damaged actions are operational exceptions. Review the issue detail drawer first so the fine rule, timeline, and member context are correct before changing the record state.

Verification checklist

  • The member and book are correctly matched in the issue modal.
  • The due date and fine rule reflect the intended circulation policy.
  • The issue appears in the table with the expected status.
  • The issue detail drawer shows the correct timeline and follow-up actions.

Expected result: the library item is tracked in the Issues & Returns workspace and can be managed through issue-detail actions until the circulation cycle is complete.

Troubleshooting

IssueLikely causeWhat to do
Member cannot be selectedSearch terms do not match a valid card or member recordSearch by card number or confirm the member exists in the library system
Book does not appear in the selectorBook availability or search terms are too narrowSearch by title or ISBN and confirm the book still has available copies
Wrong issue record opensA different book title was selected from the tableClose the detail drawer and reopen the correct row
Status is hard to find in the listFilters still point to another member type or issue stateReset filters and reapply only the values you need

Related docs