Troubleshoot Learning Plans
Check the effective policy and current state before repeating a planning action. Repetition can create confusion even when history remains protected.

Learning Plans are unavailable
Section titled “Learning Plans are unavailable”- Confirm the active school.
- Ask an administrator to open Settings → Learning Plans settings.
- Confirm the feature is available and Enable Learning Plans is selected.
- Verify the plan or learner belongs to the current school and permitted halqa.
Core sessions and recitations remain available while planning is off.
Generation creates nothing
Section titled “Generation creates nothing”Check:
- the plan is Active;
- automation is not paused;
- the effective policy is Approval required or Automatic publishing, not Teacher managed;
- active tracks remain before the destination;
- the configured rolling window is not already full;
- the selected data supports every effective workload and tolerance unit.
Page planning is refused
Section titled “Page planning is refused”The selected data does not supply verified page positions. Use a supported line or ayah unit, or ask the authorized platform owner to complete Quran-data reconciliation. Do not estimate page ranges or repeatedly regenerate.
An action is unavailable
Section titled “An action is unavailable”The assignment or plan state may not permit it. For example, only a draft can be approved or rejected, only a postponed item can be republished, and started or completed evidence is protected from replacement. Review the assignment lifecycle.
Recitation did not update the plan
Section titled “Recitation did not update the plan”Confirm the learner, recitation type, Quran range, active plan, published or in-progress assignment, and remaining segment. If more than one assignment could match, resolve it under Recitations needing a match; do not record a duplicate recitation.
Replanning did not replace work
Section titled “Replanning did not replace work”Only generated, unstarted, future draft/published/postponed work is eligible. Manual, edited, in-progress, completed, and repeat-follow-up evidence remains untouched. Also verify effective automation and dataset capability.
Escalate with the school, learner, visible plan/assignment state, action, timestamp, and error—never staff-only notes or unrelated learner data.