> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shiftlabs.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Keyrings

> Securely store and share passwords with your team

Keyrings is a secure password vault for storing, organizing, and sharing credentials with your team. All passwords are encrypted end-to-end using PGP encryption.

## Key Benefits

<CardGroup cols={2}>
  <Card title="End-to-End Encryption" icon="lock">
    All passwords are encrypted with PGP before leaving your browser. Only you and authorized team members can decrypt them.
  </Card>

  <Card title="Team Sharing" icon="users">
    Share individual passwords with team members while maintaining full control over access.
  </Card>

  <Card title="Organized Structure" icon="folder-tree">
    Use categories (folders) and tags to organize passwords into logical groups.
  </Card>

  <Card title="Import & Export" icon="arrows-rotate">
    Import from KeePass and export to KDBX format for backup or migration.
  </Card>
</CardGroup>

## How to Add a Password

<Steps>
  <Step title="Select a Category">
    Click on a category (folder) in the left panel to select where to store the password.
  </Step>

  <Step title="Click Add Password">
    Click the **Add Password** button in the top right.
  </Step>

  <Step title="Enter Password Details">
    * **Name** (required): Descriptive name (e.g., "GitHub Personal")
    * **Username**: Login username or email
    * **Password**: The secret password (use the generator for strong passwords)
    * **URL**: Website login URL
    * **Notes**: Additional information
    * **Tags**: Optional tags for organization
  </Step>

  <Step title="Save">
    Click **Save**. The password is encrypted and stored securely.
  </Step>
</Steps>

<Tip>
  Click the dice icon to generate a strong random password. You can customize length and include/exclude uppercase, lowercase, numbers, and symbols.
</Tip>

## How to Organize with Categories

Categories (folders) help organize passwords into logical groups. You can create nested categories for deeper organization.

**Create a category:**

1. Click the **+** icon next to "Categories" in the left panel
2. Enter a category name
3. Optionally select a parent category to create nested folders

**Rename or delete:**
Right-click on any category for rename/delete options.

**Drag and drop:**
Drag categories to reorganize the folder structure.

<Warning>
  Deleting a category also deletes all passwords inside it and any nested subcategories.
</Warning>

## How to Use Tags

Tags provide cross-category organization. A password can have multiple tags.

**Create a tag:**

1. Click the **+** icon next to "Tags" in the left panel
2. Enter a name and pick a color

**Filter by tag:**
Click any tag in the sidebar to filter passwords. Select multiple tags for combined filtering.

**Add tags to passwords:**
When creating or editing a password, select tags from the dropdown.

## How to Move Passwords

Move passwords between categories to reorganize your vault.

<Steps>
  <Step title="Select Password">
    Click on a password to open the actions menu, or click the row's dropdown menu.
  </Step>

  <Step title="Choose Move to Folder">
    Select **Move to Folder** from the dropdown menu.
  </Step>

  <Step title="Select Destination">
    Choose the target category from the folder tree.
  </Step>

  <Step title="Confirm">
    Click **Move**. The password is relocated to the new category.
  </Step>
</Steps>

<Info>
  You cannot move passwords that were shared with you by others.
</Info>

## How to Share a Password

Share passwords securely with team members.

<Steps>
  <Step title="Select Password">
    Click on a password to open its details panel.
  </Step>

  <Step title="Click Share">
    Click the **Share** button or select Share from the dropdown menu.
  </Step>

  <Step title="Select Users">
    Search and select team members to share with.
  </Step>

  <Step title="Confirm">
    Click **Share**. Recipients can view the password in their "Shared with Me" section.
  </Step>
</Steps>

<Info>
  Shared passwords appear in the "Shared with Me" virtual folder for recipients. The original owner maintains full control and can revoke access anytime.
</Info>

## How to Revoke Shared Access

Remove a user's access to a shared password.

<Steps>
  <Step title="Open Password Details">
    Select the password you want to manage sharing for.
  </Step>

  <Step title="View Shared Users">
    In the details panel, see the list of users the password is shared with.
  </Step>

  <Step title="Remove Access">
    Click the remove icon next to the user's name to revoke their access.
  </Step>
</Steps>

## How to Delete Multiple Passwords

Delete multiple passwords at once using bulk selection.

<Steps>
  <Step title="Select Passwords">
    Use the checkboxes on the left side of each row to select multiple passwords.
  </Step>

  <Step title="Click Delete">
    The **Delete** button appears in the toolbar showing the count of selected items.
  </Step>

  <Step title="Confirm">
    Confirm the deletion. This action cannot be undone.
  </Step>
</Steps>

## How to Import Passwords

Import existing passwords from KeePass or other password managers.

<Steps>
  <Step title="Export from Source">
    Export your passwords as a KDBX file from your current password manager.
  </Step>

  <Step title="Click Import">
    Click the **Import** button (upload icon) in the toolbar.
  </Step>

  <Step title="Upload File">
    Select the KDBX file and enter its master password.
  </Step>

  <Step title="Complete Import">
    Passwords are imported into an "Imports" category, preserving the original folder structure.
  </Step>
</Steps>

<Note>
  Only `.kdbx` files are supported. Other formats need to be converted to KDBX first.
</Note>

## How to Export Passwords

Export all passwords to a KDBX file for backup or migration.

<Steps>
  <Step title="Click Export">
    Click the **Export** button (download icon) in the toolbar.
  </Step>

  <Step title="Download File">
    A KDBX file downloads automatically.
  </Step>

  <Step title="Save Master Password">
    A temporary password is displayed. Save it to open the exported file.
  </Step>
</Steps>

<Warning>
  The export password is shown only once. Store it securely before closing the dialog.
</Warning>

## How to Copy a Password

* **Quick copy**: Click the copy icon next to any password in the list
* **From details**: Open the password details panel and click the copy icon

## Troubleshooting

<AccordionGroup>
  <Accordion title="Cannot see any passwords" icon="circle-question">
    1. Select a category from the left panel first
    2. Check if you have tag filters active (clear them)
    3. Try the search box to find specific passwords
  </Accordion>

  <Accordion title="Cannot add a password" icon="circle-question">
    * You must select a category first (virtual folders like "Shared with Me" don't allow adding)
    * You need write permission for Keyrings
  </Accordion>

  <Accordion title="Cannot edit a shared password" icon="circle-question">
    Only the owner can edit shared passwords. Passwords shared with you are read-only.
  </Accordion>

  <Accordion title="Cannot move a password" icon="circle-question">
    You cannot move passwords that were shared with you. Only the original owner can move them.
  </Accordion>

  <Accordion title="Import failed" icon="circle-question">
    1. Verify the file has a `.kdbx` extension
    2. Ensure you entered the correct master password
    3. The file may be corrupted - try exporting again from the source
  </Accordion>

  <Accordion title="Password not decrypting" icon="circle-question">
    The PGP key may need to be re-initialized. Try refreshing the page. If the issue persists, contact your administrator.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="How are passwords encrypted?">
    Passwords are encrypted end-to-end using PGP (Pretty Good Privacy) encryption. The encryption happens in your browser before data is sent to the server. Only you and people you explicitly share with have the keys to decrypt.
  </Accordion>

  <Accordion title="Can I access passwords offline?">
    No, passwords are stored server-side and require an internet connection to access.
  </Accordion>

  <Accordion title="What happens if I delete a shared password?">
    The password is removed for everyone it was shared with. They lose access immediately.
  </Accordion>

  <Accordion title="Can shared users edit passwords?">
    No. Shared passwords are read-only for recipients. Only the owner can edit or delete them.
  </Accordion>

  <Accordion title="What is the 'Shared by Me' folder?">
    This virtual folder shows all passwords you have shared with others, along with who has access.
  </Accordion>

  <Accordion title="Is there a password limit?">
    No limit. Store as many passwords as you need.
  </Accordion>

  <Accordion title="Can I recover deleted passwords?">
    No. Deleted passwords cannot be recovered. Consider exporting a backup before bulk deletions.
  </Accordion>
</AccordionGroup>