Troubleshooting

Fixes for missing buttons, wrong usage numbers, failed exports and update problems.

v1.0.3PolyForm-Strict-1.0.01 min read

A button is missing#

Perplexity changes its layout often. Check that the module is enabled in the settings dialog, reload, and look for lines starting with [Better Perplexity] in the browser console.

Usage shows free-tier numbers#

You are probably signed out in this browser profile or container. Sign in, then press Refresh in the usage dialog and read Raw API data.

My draft disappeared#

Drafts are saved per conversation for 30 days and removed only when you send, discard or restore them. If the restore banner never appears, the message box was not detected on that page.

Export fails#

Use Raw JSON, and include the HTTP status when you report it.

Updates do not arrive#

Use Check for Updates from the userscript menu. If your manager shows an older version, re-open the Install link.

The build cannot find @nolly/core#

Run bun install at the repository root, not inside better-perplexity. The core is a workspace package, so the root install links it.

Reporting a bug#

Use the bug report form with your script version, browser and manager.

Edit this page on GitHub

Search documentation

Jump to any page or section.

Better Perplexity
Install
Features
Shortcuts
Community prompts
Privacy
Troubleshooting
Built on the shared core
Development
License
Getting started
Install
Take the tour
Where things are
Turn modules on and off
Usage tracking
What the badge shows
Which mode is shown
Refill estimates
Refill estimates
When the numbers look wrong
Long messages
The size meter
Big messages
Sending in parts
Attaching as a file
Accuracy
Prompts and batches
Prompt library
Placeholders
Community prompts
Batch Runner
Code blocks and export
Code blocks
Exporting a thread
Citation styles
Shortcuts and settings
Default shortcuts
Enter as newline
Command palette
Selection toolbar
Layout
Architecture
What the core provides
What stays in Better Perplexity
Compatibility
Building from source
Troubleshooting
A button is missing
Usage shows free-tier numbers
My draft disappeared
Export fails
Updates do not arrive
The build cannot find @nolly/core
Reporting a bug
Changelog
[1.0.3] - 2026-11-09
Fixed
Changed
[1.0.2] - 2026-11-09
Changed
[1.0.1] - 2026-11-09
Changed
Fixed
[1.0.0] - 2026-11-08
Added
Community prompts
Suggest a prompt
Userscript Core
What you get
Quick start
Getting started
Scaffold
A feature
Wire it up
Cleanup
API reference
Runtime
Feature
Utilities
Build
Build and release
Changelog
0.1.1
0.1.0