How to Import Your NHS Rota from Allocate/Metro into Shiftlyx (Complete Guide)
How to Import Your NHS Rota from Allocate/Metro into Shiftlyx
Your NHS rota is already approved. You have seen it in the Loop app (or Allocate or Metro) and you know which shifts you are working this month. The last thing you want to do is manually type every shift into another app.
Good news: you do not have to. Shiftlyx can import your official rota directly from Loop's ICS feed. Here is exactly how to do it.
What You Need
Step 1: Generate Your iCal Link from the Loop Web Portal
The correct way to get your roster into Shiftlyx is through the Loop web portal (not the mobile app). Here is the exact workflow:
1. Go to your trust's Loop web portal (the website you use to view your rota on a computer)
2. Log in with your NHS trust credentials
3. In the sidebar menu, click **"Rostering"**
4. Under **"Personal Rostering"**, find and click **"View and share your roster calendar on other devices"** — this links to the Calendar links section
5. Click **"Calendar links"**
6. Click **"Add new"** to create a new calendar link
7. Give it a name (e.g. "Shiftlyx Sync" or "My Rota")
8. Click submit/save — Loop generates a unique iCal link for you
9. Copy the generated iCal link to your clipboard
> That's it. This link contains your approved rota as a machine-readable calendar feed. It updates automatically when your trust publishes rota changes.
Step 2: Import into Shiftlyx
Open Shiftlyx and navigate to the calendar view. Tap the **"Import Rota"** button in the top toolbar.
You have three ways to import:
**Method 1: Paste the iCal URL (best method)**
1. In the import sheet, select the "From URL" tab
2. Paste the iCal link you copied from the Loop portal
3. Shiftlyx automatically normalises the URL (it handles webcal://, webcals://, and bare hostnames)
4. Tap "Import"
5. The app downloads and parses your entire rota
**Method 2: Upload an ICS file**
1. Download your rota as an ICS file from Loop (look for "Download" or "Export File" in the portal)
2. In Shiftlyx, select the "From File" tab
3. Browse and select the .ics file from your device
4. Tap "Import"
**Method 3: Paste the raw ICS content**
1. If the URL method does not work, open the iCal link in a browser on your device
2. The browser will either download the file or show raw text starting with "BEGIN:VCALENDAR"
3. Copy all of that text
4. In Shiftlyx, select the "Paste ICS" tab
5. Paste the content and tap "Import"
Step 3: Review and Confirm
After parsing, Shiftlyx shows a **Reconciliation Preview** summarising:
Review the mapping and confirm the import. Your shifts are now loaded with the correct dates, times, and types.
How Shift Type Mapping Works
Shiftlyx understands the standard shift codes used across NHS trusts:
| Code | Shift Type | What Shiftlyx Maps To |
|------|-----------|----------------------|
| LD | Long Day | Long Day (7:00-19:30 typical) |
| MLD | Medium Long Day | Medium Long Day |
| TW | Twilight | Twilight (13:00-21:00 typical) |
| N | Night | Night (19:00-07:30 typical) |
| E | Early | Long Day |
| L | Late | Twilight |
| AL | Annual Leave | Annual Leave |
| SL | Study Leave | Study Leave |
If your trust uses non-standard codes, Shiftlyx will flag the unmapped shifts so you can correct them manually during the review step.
What Happens Next
Once imported, your rota feeds into Shiftlyx's automatic fatigue analysis:
Troubleshooting
| Problem | Solution |
|---------|----------|
| "URL did not return a valid ICS file" | The URL may require authentication. Try opening it in a browser first, then use Method 3 to paste the content |
| "No shifts found" | Your trust may use different event labels. Try the manual paste method and check the raw content starts with BEGIN:VCALENDAR |
| Shift types are wrong | Some trusts use codes that differ from the standard. During the reconciliation preview, you can change any shift type before confirming |
| Import button is not showing | Make sure you are on the calendar screen. The Import Rota button appears in the calendar toolbar |
| "HTTP 403/401" | The ICS feed URL may be session-locked. Try exporting as a file (Method 2) instead |
Why Not Automatic Sync?
You might wonder why Shiftlyx does not automatically sync with NHS rostering systems. The answer is intentional: Shiftlyx is a personal tool. Your employer should not control access to your shift analysis tool. Automatic sync would require either NHS trust APIs (which do not exist for third-party apps) or sharing your login credentials (which we will never ask for).
The ICS import method gives you control. You choose when to update. You see exactly what is imported. No background access required.
Need Help?
If your trust uses a different rostering system or the import does not work as expected, contact us via the app or email. We add support for new formats regularly based on user reports.
---
*Shiftlyx is a planning aid, not a medical device. Always follow your trust's policies and consult appropriate professionals for health concerns.*