Overview
Heir Access is a secure emergency access feature that allows you to designate trusted individuals who can access your portfolio in case of incapacitation or death. This ensures your valuable asset records aren’t lost and your beneficiaries can access important information when needed.What is Heir Access?
Heir Access provides a secure mechanism for designated individuals to access your portfolio through two distinct paths:- Heir-Initiated Request: Heirs request access and a waiting period begins (14-90 days)
- Account Holder Pre-Approval: You grant immediate access without a waiting period
Why Heir Access Matters
Estate Planning
Emergency Preparedness
Digital Legacy
Insurance Claims
Requirements
Before using Heir Access, ensure:Pro Subscription (Both Users)
Pro Subscription (Both Users)
- Account holder must have Pro or Lifetime subscription
- Heir must also have Pro or Lifetime subscription
- If either user downgrades to Free, access is immediately revoked
- Continuous subscription validation ensures both users maintain Pro
Heir Must Have Storehouses Account
Heir Must Have Storehouses Account
- Heirs must register for their own Storehouses account
- Use the same email address you’ll designate them with
- Heirs cannot be added until they have an active account
Both Users Active
Both Users Active
- Account holder and heir must both have active accounts
- Heirs cannot be yourself
- Each heir is validated when added and during access requests
How Heir Access Works
There are two paths to grant heir access:Path 1: Heir-Initiated Request (With Waiting Period)
This path includes built-in security waiting periods:You Designate Heirs
Heir Requests Access
Waiting Period Begins
You're Notified
You Can Deny Request
Final Notice
Access Granted (If Not Denied)
Path 2: Account Holder Pre-Approval (Immediate Access)
You can grant access immediately without a waiting period:You Designate Heir
Click 'Grant Access Now'
Confirm Access
Heir Receives Email
Access Active
Security Features
Time-Delayed Access (Path 1)
Time-Delayed Access (Path 1)
- Configurable waiting period (14-90 days)
- Default 30-day waiting period prevents unauthorized access
- Sufficient time to deny requests if you’re still active
- You receive notifications throughout the waiting period
Email Notifications
Email Notifications
- Notification when access request is initiated
- Reminders at 7, 14, and 21 days into waiting period
- Final notification 24 hours before access is granted
- All notifications include one-click denial link
- Heir receives immediate notification when you grant access
- No waiting period notifications
Custom Permissions Per Heir
Custom Permissions Per Heir
- Read-only: Heir can view items and collections only
- Can Edit: Heir has full access to view, edit, and manage items & collections
- Set when adding or editing heir
- Cannot be changed while active access exists
180-Day Automatic Expiry
180-Day Automatic Expiry
- All granted access automatically expires after 180 days
- Prevents indefinite access
- Heirs can request renewal if still needed
- You can revoke access anytime before expiry
Continuous Subscription Validation
Continuous Subscription Validation
- System validates both users have Pro subscriptions
- Access automatically revoked if either user downgrades
- Prevents access after subscription lapses
- Checked during request processing and access validation
Access Logging
Access Logging
- All heir access sessions are logged in
heir_access_sessionstable - Audit trail of when heirs accessed your data
- Helps you track emergency access usage
Setting Up Heir Access
Accessing Heir Settings
Navigate to storehouses.app/heir-access or:- Go to Dashboard
- Click “Heir Access” in the sidebar
- View the Heir Access configuration page
Adding a Designated Heir
Click '+ Add Heir'
Enter Contact Information
- Full name (required)
- Email address (required - must match their Storehouses account)
- Relationship (spouse/child/parent/sibling/friend/other)
- Notes (optional: why you’re designating them)
Choose Permission Level
- Read-only: Can view items and collections (recommended)
- Can Edit: Full access to view, edit, and manage items & collections
Save Heir
- They initiate an access request (Path 1), or
- You grant them immediate access (Path 2)
Validation Checks
When adding an heir, the system validates: ✅ Heir has a Storehouses account with that email ✅ Heir has an active Pro or Lifetime subscription ✅ You have an active Pro or Lifetime subscription ✅ Heir is not yourself ✅ Heir is not already designated ❌ If any validation fails, you’ll see an error message explaining the issueMultiple Heirs
You can designate multiple heirs:- Each heir is independent
- Each can have different permission levels
- Each can initiate separate access requests
- Unlimited number of designated heirs (Pro feature)
Managing Designated Heirs
View Current Heirs
Your Heir Access page displays:- Read-only (blue badge)
- Can Edit (yellow badge)
- No Access (gray badge): No active request or approval
- Pending (yellow badge): Heir-initiated request in waiting period (shows days remaining)
- Access Granted (green badge): Active access (shows expiry date)
Edit Heir Information
To update an heir’s details:Click 'Edit'
Update Details
- Full name
- Relationship
- Notes
- Permission level
Save Changes
Remove a Designated Heir
To revoke heir designation:Click 'Remove'
Confirm Removal
- Heir designation is removed
- If they have an active access request, it’s immediately canceled
- If they have granted access, it’s immediately revoked
- They receive a notification if access was active
The Access Request Process (Path 1)
How Heirs Request Access
When an already-designated heir needs access:Visit Request Page
Enter Account Holder Email
Confirm Their Email
Submit Request
What Happens After Request
Day 0: Request Initiated- You receive immediate email notification with one-click denial link
- Heir receives confirmation their request is processing
- Waiting period begins (based on your configured waiting period)
- You receive reminder email with denial link
- Shows days remaining until auto-approval
- Another reminder email with denial link
- Urgency increases as approval approaches
- Final regular reminder with denial link
- Emphasizes approaching auto-approval
- Critical final notification
- Last chance to deny if request is unauthorized
- Includes countdown to auto-approval
- If you haven’t denied: Request auto-approves
- Heir receives “Access Granted” email
- Access granted for 180 days
- You receive notification that access was granted
- Request immediately canceled
- Heir receives notification that access was denied
- New waiting period required for future requests
Denying an Access Request
If you receive an heir access request notification: Option 1: One-Click Email Denial- Open any notification email
- Click the “Deny Access” button
- Confirm the denial on the website
- Request is immediately canceled
- Go to storehouses.app/heir-access
- Find the heir with “Pending” status
- Click “Deny Request”
- Confirm the denial
Granting Immediate Access (Path 2)
How to Pre-Approve Access
To grant access without a waiting period:Go to Heir Access Page
Find Heir with No Access
Click 'Grant Access Now'
Confirm Access
Access Granted
When to Use Pre-Approval
Good use cases:- Planned estate planning activities
- Sharing access with a trusted family member for legitimate reasons
- Medical emergencies where you’re still able to grant access
- Collaborative portfolio management with a spouse
- General emergency preparedness (use Path 1 instead)
- When you want the security of a waiting period
- Heirs you don’t completely trust
Permission Levels
Read-Only Access
What heirs can do:- View all items in the portfolio
- See item details, descriptions, and notes
- View uploaded images and documents
- Access category-specific metadata
- View current portfolio value and pricing
- View purchase prices and market values
- See collections and their contents
- View storage locations
- Export portfolio to PDF
- Export data to CSV
- Generate printed reports
- Add, edit, or delete items
- Modify account settings
- Change email or password
- Access billing information
- Set up or modify alerts
- Delete the account
- Modify collections or locations
- Create new share links
- Invite other users
- Change their permission level
Can Edit Access
Everything from Read-Only, PLUS:- Add new items to your portfolio
- Edit existing item details
- Delete items
- Create new collections
- Modify existing collections
- Update item locations
- Change item valuations
- Upload images and documents
Access Duration
Once granted (either path), heir access remains active until:- 180 days pass (automatic expiration)
- You revoke it manually
- You delete your account
- You remove the heir
- Either user downgrades from Pro (access automatically revoked)
How Heirs View Your Portfolio
Once an heir has been granted access, they can view your portfolio directly from their Collections page:Heir Logs In
Navigate to Collections
Select Portfolio Tab
- Their own portfolio
- Each heir portfolio they have access to (showing account holder’s name)
Browse Portfolio
/collections?portfolio=<requestId>. Heirs can bookmark this URL for quick access.What Heirs See
When viewing your portfolio, heirs have access to:- Dashboard view with portfolio statistics
- All items with full details, images, and metadata
- Collections and their organization
- Locations where items are stored
- Secure Storage documents marked “Share with heirs” (if you’ve enabled this)
Revoking Access
Revoking a Pending Request
During the waiting period (Path 1): Option 1: Email Link- Click “Deny Access” in any notification email
- Confirm denial
- Go to Heir Access settings
- Find the pending request (yellow “Pending” badge)
- Click “Deny Request”
- Confirm denial
Revoking Granted Access
If an heir already has active access:Go to Heir Access Settings
Find Heir with Active Access
Click 'Revoke Access'
Confirm Revocation
Access Immediately Revoked
Email Notifications
Heir Access uses automated emails sent fromheirs@storehouses.app:
For Account Holders
- Heir Request Initial Email: Sent immediately when heir requests access
- Heir Request Reminder (Day 7): First reminder during waiting period
- Heir Request Reminder (Day 14): Second reminder during waiting period
- Heir Request Reminder (Day 21): Third reminder during waiting period
- Heir Request Final Notice: Sent 24 hours before auto-approval
- Access Granted Notification: Sent when access is auto-approved
- Heir’s name and email
- Days remaining (for pending requests)
- One-click “Deny Access” link
- Link to manage heirs
For Heirs
- Request Confirmation: Sent when they submit an access request
- Access Granted Email: Sent when access is approved (auto or manual)
- Access Pre-Approved Email: Sent when account holder grants immediate access
- Access Denied Email: Sent when request is denied
- Access Revoked Email: Sent when you revoke their active access
Cron Job Processing
Heir Access uses an automated background job to process requests: Endpoint:/api/cron/process-heir-requests
Schedule: Every 6 hours (runs at 0:00, 6:00, 12:00, 18:00 UTC)
Authentication: Requires CRON_SECRET environment variable
Functions:
- Processes pending heir-initiated requests only (not pre-approved)
- Sends reminder emails at appropriate intervals
- Auto-approves requests after waiting period
- Sends access granted emails to heirs
- Marks expired requests (>180 days)
- Validates Pro subscriptions for both users
- Auto-revokes access if subscriptions lapse
Best Practices
Choose Trusted Individuals
Choose Trusted Individuals
- Select people you absolutely trust
- Consider their technical capability
- Ensure they understand their role
- Discuss your wishes beforehand
- Verify they have or can get Pro subscription
Inform Your Heirs
Inform Your Heirs
- Let them know they’re designated
- Explain the two paths to access (heir-initiated vs. pre-approval)
- Provide them with your account email
- Document the process in estate plans
- Ensure they know about Pro subscription requirement
Use Appropriate Waiting Periods
Use Appropriate Waiting Periods
- 30 days: Recommended for most users
- 14 days: If you have frequent portfolio access
- 60-90 days: If you travel extensively or have irregular access
- Longer periods provide more security against unauthorized requests
Choose Permission Levels Carefully
Choose Permission Levels Carefully
- Read-only: Default choice for most heirs (estate settlement, viewing only)
- Can Edit: Only for heirs who need to manage your portfolio
- Consider the heir’s technical ability
- Think about their intended use case
Designate Multiple Heirs
Designate Multiple Heirs
- Primary: Spouse or closest family member
- Secondary: Adult child or trusted family member
- Tertiary: Estate executor or attorney
- Each provides backup if others cannot access
- Multiple heirs prevent single point of failure
Review Regularly
Review Regularly
- Review designations annually
- Update contact information as needed
- Remove heirs who are no longer appropriate
- Verify heirs still have Pro subscriptions
- Adjust permission levels based on life changes
Document in Estate Plan
Document in Estate Plan
- Include Heir Access info in will or trust
- Inform executor about the feature
- Document your account email
- Explain the access request process
- Note that both users need Pro subscriptions
Monitor Email
Monitor Email
- Keep your email account secure
- Regularly check for access request notifications
- Respond promptly to any unexpected requests
- Add heirs@storehouses.app to contacts
Estate Planning Integration
How Heir Access Supports Estate Settlement
Asset Discovery
Valuation
Location Information
Documentation
Distribution
Working with Estate Professionals
Your designated heirs can share exported data with:- Estate attorneys
- Accountants and tax professionals
- Insurance agents
- Appraisers
- Auction houses
- Financial advisors
Troubleshooting
Can't Add Heir
Can't Add Heir
- Heir doesn’t have a Storehouses account → Have them create one first
- Heir doesn’t have Pro subscription → They must upgrade to Pro
- You don’t have Pro subscription → Upgrade to Pro or Lifetime
- Email address typo → Double-check the email matches their account
- Heir is already designated → Check your heirs list
Heir Can't Request Access
Heir Can't Request Access
- Email address doesn’t match designation
- Your account email is incorrect
- Heir is not actually designated
- Previous request is still pending
- Either user doesn’t have Pro subscription
Not Receiving Notifications
Not Receiving Notifications
- Check spam/junk folders
- Verify your account email is correct
- Add heirs@storehouses.app to contacts
- Check email settings in your account
- Verify emails aren’t being filtered
Can't Deny Request
Can't Deny Request
- Log into your account directly
- Navigate to Heir Access settings
- Manually deny from the dashboard
- Contact support if issues persist
Heir Has Access Issues After Approval
Heir Has Access Issues After Approval
- Verify the waiting period has fully elapsed (Path 1)
- Check their email for access instructions
- Ensure they’re logging into the correct account
- Verify both users still have Pro subscriptions
- Check access hasn’t expired (180 days)
- Contact support for assistance
Access Unexpectedly Revoked
Access Unexpectedly Revoked
- 180 days have passed since approval
- Account holder downgraded from Pro
- Heir downgraded from Pro
- Account holder removed the heir
- Account holder manually revoked access
Comparison with Share Links
Frequently Asked Questions
Why do heirs need their own Pro subscription?
Why do heirs need their own Pro subscription?
- Prevents system abuse
- Ensures serious, committed usage
- Validates heir identity through paid account
- Reduces frivolous or malicious access requests
- Helps sustain the service for both users
Can I have multiple heirs?
Can I have multiple heirs?
- Is independent
- Has their own permission level
- Can initiate separate access requests
- Can be granted immediate access separately
What if I pass away during the waiting period?
What if I pass away during the waiting period?
Can I extend the 180-day access period?
Can I extend the 180-day access period?
- Heir can submit a new access request (Path 1)
- You can grant new immediate access (Path 2)
- This ensures ongoing validation of both users’ Pro status
What happens if I downgrade from Pro?
What happens if I downgrade from Pro?
- All active heir access is immediately revoked
- Pending requests are canceled
- Heirs receive notification
- Heir designations are preserved
- Access resumes if you re-upgrade to Pro
What happens if my heir downgrades from Pro?
What happens if my heir downgrades from Pro?
- Their active access is immediately revoked
- They cannot submit new access requests
- You cannot grant them immediate access
- They must re-upgrade to Pro to regain access
Can I grant immediate access without the waiting period?
Can I grant immediate access without the waiting period?
- Click “Grant Access Now” button next to any heir
- Access is granted immediately for 180 days
- No waiting period or notifications
- Heir receives immediate email notification
What's logged in heir_access_sessions?
What's logged in heir_access_sessions?
- When heirs access your portfolio
- Which heir accessed it
- Timestamps of access
- This provides an audit trail for security and estate documentation
Can heirs access my account settings or billing?
Can heirs access my account settings or billing?
- View or change account settings
- Access billing information
- Change your email or password
- Delete your account
- Modify heir access settings
- Create new heirs

