<!-- https://unlockos.io/manual/key-expiration -->

# About QR Code Expiration

## When Does Your Access Key Expire?

The validity period depends on your plan type and key type.

---

## Entry Key (QR Code at Check-in)

### One-Time Plans
- **Valid for**: 3 minutes after check-in
- **After expiration**: Shows grayscale + "Expired" label
- **What to do**: You need to check in again (cannot refresh)

### Time-Based Plans (Hourly, Flat + Overage, Time Slot)
- **Valid for**: 3 minutes after check-in
- **After expiration**: Shows grayscale + "Expired" label
- **What to do**:
  - ✅ Opening the check-in modal again automatically gets a new key
  - ✅ Or click the "🔄 Update" button to manually refresh

### Accommodation & Daily Flat Plans
- **Valid for**: Until your check-out time (hours to days)
- **After expiration**: No grayscale display (expiration is far in the future)
- **What to do**: No action needed. Use the same key until checkout

---

## Exit Key (QR Code at Check-out)

### All Plans (Unified)
- **Valid for**: 3 minutes after check-out
- **After expiration**: Shows grayscale + "Expired" label
- **What to do**:
  - ❌ Exit keys cannot be refreshed (single-use)
  - Exit within 3 minutes
  - If expired, contact the facility

---

## What Expired Keys Look Like

### Active Key
```
┌─────────────┐
│             │
│   ██████    │
│   ██  ██    │
│   ██████    │
│             │
│  Black QR   │
│ (Valid Until)
└─────────────┘
```

### Expired Key
```
┌─────────────┐
│   Expired   │
│             │
│   ░░░░░░    │  ← Grayscale
│   ░░  ░░    │    (Faded)
│   ░░░░░░    │
│             │
└─────────────┘
```

---

## Frequently Asked Questions

### Q: What happens if I use an expired key?
**A**: The door won't unlock. For entry keys, open the modal again or click the update button. For exit keys, contact the facility.

### Q: When does the update button appear?
**A**: Only for time-based plans (hourly, flat + overage, time slot). Not for one-time, accommodation, or daily flat plans.

### Q: Will I get a new key if I open the modal again?
**A**: For time-based plans, yes—a new 3-minute key is automatically provided. For other plans, the existing key is shown.

### Q: I can't check in/out within 3 minutes...
**A**: Try these:
1. **Time-based plans**: Click the "🔄 Update" button
2. **Other plans**: Close and reopen the modal
3. **Still stuck**: Contact the facility

---

## How to Prevent Expiration

### One-Time & Exit Keys
- Expiration is unavoidable
- **Exit within 3 minutes**

### Time-Based Plans
- Reopen the modal or click "🔄 Update"
- Usually just reopening is enough

### Accommodation & Daily Flat Plans
- Keys typically don't expire
- Use the same key until check-out

---

## Troubleshooting

### Modal won't open / Update button not responding
- Disable battery saver mode
- Check internet connection
- Contact the facility

### New key isn't appearing
- Close and reopen the modal
- Wait a moment (key may be generating)
- Contact the facility

### Shows "Expired" but key still works
- Refresh your browser
- Clear browser cache

---

## Key Revocation at Checkout

When checkout occurs (manual or automatic), your entry key is automatically revoked.

### How Revocation Works

- **Manual checkout**: Your entry key is revoked when you complete the checkout process
- **Auto-checkout**: When the plan's usage period ends and auto-checkout occurs, your entry key is revoked simultaneously
- **Quick Mode deactivation**: If the facility owner deactivates the URL, your key is also automatically revoked

### What Happens with a Revoked Key

A revoked key will not unlock the door. If you need a new key, you must check in again.

---

## Additional FAQ

### Q: Will my key stop working after checkout?
**A**: Yes, your key is automatically revoked at checkout. This applies to both manual checkout and auto-checkout.

### Q: Do I get an exit key if I'm auto-checked out?
**A**: Auto-checkout does not automatically issue an exit key. If you need an exit key, please contact the facility.

---

## Learn More

For detailed information about your plan, ask the facility staff.

---

## Related Pages

- [Access Key Display (QR, PIN & Remote Unlock)](key-display.md)
- [Check-In Help](guest-checkin.md)
