Hazel support

A welcome should
feel easy to begin.

Find answers for creating a welcome, exchanging a signed review, publishing a letter, or managing the content stored on your device.

Start here

From a real group to one addressed letter.

The current release is a local-first publisher. Your group, private evidence and editions stay on the device where you create them.

  1. 01

    Create the group and add one newcomer

    Open Welcome, start a welcome group and choose Address the letter. Add the person who is arriving and the context their first day should reflect.

  2. 02

    Keep permission and exact words together

    Record a permitted source in the private register. Keep the public credit, select the exact excerpt and mark anything uncertain or outdated.

  3. 03

    Ask for a signed decision

    Pin a reviewer device key after comparing the complete fingerprint. Export the exact review request, then import the signed reply returned through Files or the share sheet.

  4. 04

    Publish for one person

    Choose the approved entries and reading order, preview the public letter, set its reading period and publish. Export the approved HTML letter only when you intend to share it.

Common questions

The answers that resolve most requests.

01 Where is my Hazel content stored?

Groups, newcomers, permitted evidence, review records and editions are stored locally in Hazel's file-protected application storage. Hazel 1.0 does not operate a content server or account archive.

If you delete the app or clear its local data, Hazel cannot restore that content from a Hazel account or server. Exported letters and review files remain wherever you saved or sent them.

02 Why will my signed review not import?

A reply must match the current request exactly, use the pinned reviewer key and carry a valid signature. Edits to wording, credit, audience or required reviewers invalidate older decisions and require a fresh request.

Check that the request came from this group and that you are importing the newest reply. Hazel rejects unknown keys, stale revisions, tampered files and non-newer replacement decisions.

03 Why is a welcome letter closed or unavailable?

A managed edition closes when its reading period expires, a source permission is withdrawn, the recipient is removed, or a reviewer signs a rejection for the exact published revision. This is an intentional trust state, not a loading error.

A later approval can support a new edition. It does not reopen a letter that has already been purged or an HTML file that has already been exported.

04 How do I share a review request or approved letter?

Use the native share action or Save signed reply to Files and Save approved letter to Files. These actions prepare real JSON or HTML files and do not create a delivery receipt.

Anyone holding an exported file can keep or forward that copy. Choose the destination carefully before sharing private context or a recipient-specific letter.

05 Can I use Hazel without an account or internet connection?

The welcome publisher and its local files can operate without a Hazel account. Apple sign-in and the review-account path are app access and identity surfaces; they do not create a Hazel cloud workspace.

Apple services and file destinations may require a connection or account under their own terms. The current app does not include ads or analytics collection.

06 How do I report, block or delete content?

Open People to report or block a person associated with your local groups. Open Me for privacy controls, reports, blocked people, permissions and account deletion.

Reports and blocks are stored locally in this release. There is no moderation backend. The in-app deletion flow removes local app data and Keychain identity state; it cannot recall files or letters you already exported.

Before you contact us

A few checks can usually clear the path.

01

Restart Hazel

Close the app completely, reopen it and retry the action. A canceled file import should return quietly without changing the draft.

02

Confirm the current revision

If wording changed, export a new review request. An earlier signed reply belongs only to the older revision.

03

Choose a local file destination

Use Files or a share destination you control. Verify that the JSON or HTML file was saved before closing the export sheet.

04

Update iOS and Hazel

Install the latest available versions, restart the device if file pickers or share sheets are not responding, then try again.

Still need help?

Tell us where the welcome stopped.

Use the Hazel project support channel for product help, privacy requests and app issues. We cannot retrieve local content that is no longer on your device.

Include in your request

  • Hazel version and build number
  • Device model and iOS version
  • The screen you were using
  • What you expected and what happened
  • A screenshot with private source material removed
Hazel project support Open support channel

Do not include reviewer private keys, unapproved source text, exported letters or personal information about another person.