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

# Troubleshooting

> Find the cause of common account, knowledge, sharing, and connection problems.

<CardGroup cols={2}>
  <Card title="My agent cannot find a page" href="/help/agent-cannot-find-page">
    Check sources, scope, authentication, and stale copies.
  </Card>

  <Card title="My changes are not syncing" href="/help/sync-not-updating">
    Find the blocked direction and preserve your work.
  </Card>

  <Card title="I cannot edit a page" href="/help/cannot-edit">
    Check the specific role and connection grants.
  </Card>

  <Card title="My share link does not work" href="/help/share-unavailable">
    Check audience, expiration, and the current subtree.
  </Card>
</CardGroup>

## I cannot open a workspace or invitation

Check the signed-in email, the active workspace, and whether the invitation
expired. Invitations last 72 hours and are single-use. Ask the sender for a new
invitation when needed. A paused workspace needs action from its billing owner;
creating another workspace does not repair that subscription.

## I cannot edit, share, or create a team vault

Check the [vault role](/collaboration/vault-access) and plan. Editing requires
Editor or Vault admin. Share-link management requires Vault admin. Team vaults
and groups require a supported plan and administrative permission. A stronger
grant from another group may explain access that remains after a direct grant is
removed.

## My search misses a page

Confirm the workspace and scope. Personal vaults require explicit selection. Try
a distinctive phrase actually present in the saved source and fewer query words.
Search excludes deleted/history content, the separate Skills and Templates
libraries, profiles, and Follow-ups. Markdown copied into a vault remains
ordinary searchable knowledge, including files under `skills/`.

## Import or conversion skipped my source

Markdown imports require valid UTF-8 `.md` files, portable names, a supported
size, and a batch within 500 files/folders. Review the import result. For
conversion, check public URL accessibility, supported file type, captions for
YouTube, available credits, and a vault skill for photos or enhancement.

## A share says unavailable

The link may be expired, rotated, revoked, outside the current shared subtree,
or blocked by workspace policy or lifecycle. An Organization link also needs
active membership. Ask the vault admin to check the link's current settings. Do
not post an Anyone URL publicly while seeking help.

## I installed desktop but no local files appeared

Installation provides the viewer. Use **Connections → Set up this machine** and
finish the agent prompt or Manual install. If already paired, check the selected
mounts and run `nlkb doctor` rather than enrolling again.

## Sync stopped or my local edit changed back

Check [sync health](/connections/sync-health), the daemon, network access, and
**Conflicts**. The normal local path may show accepted cloud text while a
competing body is retained for resolution. Do not delete managed state or reset
the replica before reviewing it.

## I lost a key or pairing code

An expired, unused pairing code can be reissued. A durable key cannot be
recovered from inventory: rotate it and verify the replacement before revoking
the old one. Deleting a connection is full revocation, not a way to display its
secret.

## Get help

Contact [Northern Logic support](mailto:logan@northernlogic.ai). Include the
screen or command, workspace name, approximate time, platform and client
version, error text, and what you expected. For lost content, include the
approximate vault/path and last known good time.

Do not send passwords, pairing codes, durable keys, Anyone-share URLs, or an
entire private knowledge root. Redact screenshots and diagnostic excerpts to the
issue being investigated.
