Support

Help with PuffTab for iOS, PuffTab on the web, and your CanPUFF files.

For support, bug reports, or feature requests

Your records, backups, and transfers

Which version of PuffTab is this help for?

The sections below cover both apps. PuffTab for iPhone and iPad includes Siri Shortcuts, widgets, Apple Watch, and optional iCloud sync. The free web app runs in your browser and is still in development; it does not include all the iOS features.

Do I need an account?

Neither app requires a PuffTab account. Optional iCloud sync in the iOS app uses your own Apple account.

Where are my records stored?

The iOS app stores records on your device by default, with optional storage in your personal iCloud account. The web app stores records locally in the browser you use. PuffTab’s servers do not keep a copy of your journal. Export backups regularly, especially before changing browsers or clearing browser data.

How do I export a CanPUFF backup?

iOS: Open More → Settings → Import & Export and choose Export CanPUFF Vault. Save the resulting file somewhere you control.

Web: Open More → Import & Export, choose Build .canpuff.zip, then Share / save export. Building the export is only the first step: save a copy outside the browser.

How do I import a CanPUFF file?

Keep a backup of your existing records first.

iOS: Open More → Settings → Import & Export → Import CanPUFF Vault and select your .canpuff.zip file.

Web: Open More → Import & Export → Choose vault file. Select your .canpuff.zip file and review the import summary and any warnings.

Can I use an older JSON backup in the web app?

The web app does not currently import legacy PuffTab JSON backups. Keep the original backup. Use the iOS app to import it, then export a CanPUFF vault for the web app. If you cannot access the iOS app, contact support before changing or deleting your backup.

Will changes sync between the iOS and web apps?

No. CanPUFF export and import lets you transfer records between them, but later changes do not automatically carry across. iCloud sync connects the native app on your Apple devices; it does not connect to the web app.

What is CanPUFF?

CanPUFF is an open, documented file format for personal cannabis records, including puffs, supplies, notes, and photos. It lets you keep your records in files you own. The core format is a release candidate; the separate encrypted vault profile is still a draft. A standard CanPUFF export should be treated as a private, unencrypted backup.

How do I delete my records?

Export and save a backup first if you want to keep your history.

iOS: Data deletion controls are in More → Settings → Import & Export. iCloud has a separate Clear iCloud Data control in Settings. Read the confirmation for the storage you are using before proceeding.

Web: Open More → Import & Export → Delete local data. This deletes the journal in that browser. Saved export files are separate and remain wherever you saved them.

Help with the iOS app

Getting started

See the step-by-step guide for adding supplies and logging puffs. If you can’t log a puff, check that you have an active supply with grams remaining.

Siri Shortcuts

Open Apple’s Shortcuts app, create a shortcut, and look for PuffTab actions. See the Shortcuts guide for setup instructions.

Home screen widgets

Open PuffTab once, then look for it in the home screen widget gallery. iOS controls when widgets refresh, so updates may not appear immediately. If a widget stays out of date, try removing and adding that widget again.

iCloud sync

Open More → Settings and look for Sync with iCloud. Follow any migration and restart instructions shown by the app.

Check that your devices use the same Apple account and have an internet connection.
Check that sync is enabled in PuffTab and that you have available iCloud storage.
Allow time for changes to arrive on your other device.
If records are missing or duplicated, save an export from each device and contact support before deleting data or changing sync settings.

Crashes or freezes

Check for a PuffTab update in the App Store, close and reopen the app, and restart your device if needed. If the problem continues, contact support with the steps that trigger it. Avoid deleting the app as a troubleshooting step unless you have saved a backup.

Help with the web app

My journal looks empty

Make sure you’re using the same device and browser profile where you entered or imported your records. A different browser does not automatically have that journal. If browser data was cleared, you’ll need a saved CanPUFF export to import your records again.

An import fails or shows warnings

Check that the file is a CanPUFF vault ending in .canpuff.zip, rather than a legacy JSON backup. Keep the original file and note the exact error or warning. If the import reports conflicts, review the summary before continuing to edit records.

The app won’t load or save

Use an up-to-date browser and check that it has available storage. If the app still opens, export and save your records before troubleshooting. Don’t clear site data to fix a loading problem without a backup: that can remove your local journal. Contact support if you can’t access your records.

Report a bug

Email support@pufftab.com with:

Whether you’re using the iOS app or web app
Your device model and operating system version
Your PuffTab version for iOS, or browser name and version for the web app
What you were trying to do, what happened, and any exact error message
A screenshot if it helps, with private details hidden

You don’t need to send your journal or a full backup to report a problem. Start with a description of the issue.

Feature requests

Have an idea? Email support@pufftab.com with “Feature Request” in the subject and let us know which app it’s for.

Age Verification