Getting Help

Setting up Google Sheets sync involves connecting your Google account and selecting or creating a spreadsheet.
Step-by-step setup:

Step 1: Connect to Google
Open the extension sidebar
Select "Google Sheets" as your sync service
Click "Connect" in Step 1
Sign in with your Google account
Grant access to Google Sheets (the extension needs permission to read and write to your spreadsheets)
Wait for the "Connected" status

Step 2: Select or create a Google Sheet
You have two options:
Option A: Create a new sheet
Click "Create New Sheet"
Enter a name (or use the default)
The extension creates the spreadsheet and connects automatically
Your prompts will sync to this new sheet
Option B: Use an existing sheet
Click "Select Sheet"
The Google Picker opens — select your spreadsheet
The extension automatically extracts the Sheet ID and connects
If needed, specify the sheet tab name (default is "Sheet1")
Your prompts will sync to this existing sheet

Step 3: Done
You'll see connection status: "Connected"
Your Sheet ID and name are displayed
Prompts automatically sync when you save them

Important notes:
The extension requires the Google Sheets API permission
OAuth tokens expire after 1 hour but auto-refresh when you use the extension
You must have edit permissions on the selected sheet
The extension automatically creates the correct column structure (Title, Prompt, Tags, Last Updated, ID)

Troubleshooting:
If authentication fails, check your internet connection
If you see "OAuth app in Testing mode", the extension's OAuth app needs to be published (usually not required for end users)
If sync fails, verify the sheet exists and you have edit permissions
Check the browser console (F12) for detailed error messages

Setting up Notion sync requires creating a Notion integration and linking it to a database. For linking an existing database, create the page/database first and share it with the integration.
Step-by-step setup:

Step 0: Create a page or a database for your Prompts in your Notion Workspace

Step 1: Create a Notion integration
Go to Notion Integrations
Click "+ New integration"
Name it (e.g., "AI Prompt Saver")
Select your workspace
Grant these capabilities:
Read content, Update content, Insert content
Click "Submit"
Configure a new "Access", select a page you have created before
Copy the Internal Integration Secret (starts with secret_)

Step 2: Set up the integration in the extension
Open the extension sidebar
Select "Notion" as your sync service
In Step 1, paste your Integration Secret
Click "Connect" or "Set up Integration"
Wait for "Integration set up successfully!"

Step 3: Create or link a database

You have two options:

Option A: Create a new database (recommended)
Click "Create Database"
The extension creates a new database with the correct schema:
Title (title property)
Prompt (rich text property)
Tags (multi-select property)
Last Updated (date property)
ID (rich text property)
The database is automatically linked and ready to use
No manual page creation or sharing needed

Option B: Link an existing database
Important: You must create the page/database in Notion first and share it with your integration before linking it in the extension.
Create a page in Notion:
Create a new page in your Notion workspace where you want to store prompts
You can create a blank page or add a database to it
Share the page with your integration:
Open the page/database in Notion
Click the "..." menu (top right)
Select "Add connections" or "Connections"
Find and select your integration (e.g., "AI Prompt Saver")
The integration now has access to this page/database
Link the database in the extension:
Copy the database URL or ID from Notion
Paste it into the "Database URL or ID" field in Step 2 of the extension
The extension validates the schema and links the database
If validation fails, ensure the database has the correct properties (or use "Create Database" instead)

Important notes:
For Option A: The extension handles page creation and sharing automatically
For Option B: You must create the page/database and share it with the integration first
The database must have the correct schema (use "Create Database" to ensure this)
Your integration must be connected to the database in Notion before linking
Integration tokens don't expire but can be revoked in Notion
The extension automatically syncs prompts when you save them

Troubleshooting:
If "Invalid token" appears, check that your Integration Secret starts with secret_ and is copied correctly
If "Schema validation failed" appears, the database doesn't have the correct structure — use "Create Database" instead
If you see "Integration has no access", share the database with your integration in Notion (Step 2 above)
If linking fails, verify the page/database exists and is shared with the integration
Check the browser console (F12) for detailed error messages

Authentication failures can happen for several reasons. Here are common causes and fixes:

Google Authentication Issues:
Common causes:
OAuth app in "Testing" mode (rare for end users — the extension includes a pre-configured app)
Network connectivity issues
Browser blocking popups
Account permissions
Token expiration

Troubleshooting steps:
Check your internet connection
Allow popups for Google sign-in
Try signing out and signing back in
Clear browser cache and cookies for Google
Check the browser console (F12) for error messages
Verify you're using the correct Google account
If you see "redirect_uri_mismatch", this is usually a developer configuration issue (rare for end users)

Token management:
Google OAuth tokens expire after 1 hour but auto-refresh when you use the extension
If authentication fails repeatedly, try disconnecting and reconnecting
You can manually disconnect via "Disconnect" in the settings

Notion Authentication Issues:
Common causes:
Invalid Integration Secret
Integration not shared with database
Integration capabilities missing
Token format errors

Troubleshooting steps:

Verify your Integration Secret:
-Must start with secret_
-Should be 50+ characters
-Copy the entire token without extra spaces

Check integration access:
-Open your database in Notion
-Click "..." → "Add connections"
-Ensure your integration is listed and connected

Verify integration capabilities:
-Go to Notion Integrations
-Open your integration
-Ensure "Read content", "Update content", and "Insert content" are enabled

Test the token:
-Copy the Integration Secret again
-Paste it into the extension settings
-Remove any leading/trailing spaces

Check the browser console (F12) for specific error messages

General troubleshooting:
-If issues persist, disconnect and reconnect
-For Google: Try disconnecting, clearing browser data, and reconnecting
-For Notion: Try creating a new integration and database
-Check Firefox extension permissions in about:addons
-Ensure the extension is up to date

Understanding sync helps you manage your prompts.

How syncing works:
Local storage first: All prompts are stored locally in your browser
Cloud sync: Prompts sync to Google Sheets or Notion when configured
Auto-sync: When enabled, prompts automatically sync when you save them
Manual sync: You can manually push or pull at any time

Push vs Pull:

Push to Sheets/Notion (Upload):
Uploads all local prompts to the cloud
Overwrites cloud data with local data
Use when you've made changes locally and want to update the cloud
All prompts in the extension are sent to the cloud

Pull from Sheets/Notion (Download):
Downloads all prompts from the cloud
Overwrites local data with cloud data
Use when you've made changes in Google Sheets/Notion and want to update the extension
Warning: This replaces all local prompts with cloud data

Auto-sync behavior:
When auto-sync is enabled, prompts automatically sync when you save them
This happens silently in the background
No manual action needed
If auto-sync fails, the prompt is still saved locally

Sync workflow example:
Create a prompt in the extension → Saved locally
Auto-sync pushes it to Google Sheets/Notion
Edit the prompt in the extension → Saved locally and pushed to cloud
Edit the prompt in Google Sheets/Notion → Pull to update the extension

Important notes:
Always pull before making major changes to avoid conflicts
Push after making local changes to back them up
Pull overwrites local data — back up important prompts first
The extension uses unique IDs to match prompts between local and cloud
If you delete a prompt locally and push, it won't delete it from the cloud (IDs are preserved)

Best practices:
Use auto-sync for convenience
Pull regularly if you edit prompts in the cloud
Push before switching devices or reinstalling
Pull after connecting to a new sheet/database to load existing prompts
Use tags and search to manage large collections

Yes, you can switch between Google Sheets and Notion at any time, and you won't lose your data if you do it correctly.

How switching works:
Important: The extension uses an identical schema for both services, so prompts transfer seamlessly.

To switch services:
Option 1: Switch and keep local data (recommended)
Your prompts are stored locally in the browser
Disconnect from the current service (optional — you can keep it connected)
Select the new service (Google Sheets or Notion)
Set up the new service following the setup wizard
Push your local prompts to the new service
Your prompts are now synced to the new service
Option 2: Pull from new service first
Set up the new service
Pull prompts from the new service (this overwrites local prompts)
Your local prompts are replaced with the new service's data

Data safety:
Your data is stored in three places:
Local browser storage (always available)
Google Sheets (if connected)
Notion (if connected)

You won't lose data if:
You switch services — local data remains
You disconnect from one service — data stays in that service
You push before switching — data is backed up

You might lose data if:
You pull from a new service without backing up first — local data is overwritten
You delete prompts locally and push — deletions sync to the cloud
You uninstall the extension without syncing — local data is lost

Best practices when switching:
Push your current prompts to back them up before switching
Don't delete the old connection immediately — keep it as a backup
Test the new service with a few prompts before switching completely
Pull from the new service after setup to load existing prompts (if any)
Keep both services connected if you want redundancy

Example workflow:
Currently using Google Sheets with 50 prompts
Want to switch to Notion
Push all prompts to Google Sheets (backup)
Set up Notion integration
Push all prompts to Notion (they sync with the same schema)
Now synced to both services
Optionally disconnect from Google Sheets (data remains in Google Sheets)

Important notes:
The schema is identical, so prompts transfer without modification
Tags, titles, and content are preserved
Timestamps are preserved
Unique IDs are preserved
You can use both services simultaneously

Drag & drop lets you quickly insert saved prompts into website input fields.

How to use drag & drop:

Step-by-step:
Open the extension sidebar (click the extension icon)
Find the prompt you want to use
Click and hold on the prompt card
Drag it to any text input field on the current page:
Text areas
Input fields (text, email, search, URL)
ContentEditable elements (rich text editors)
Release to drop the prompt
The prompt text is inserted at the cursor position

Visual feedback:
While dragging, the prompt card shows a "dragging" state
When hovering over a valid drop target, you'll see a blue dashed outline
After dropping, the input field briefly highlights to confirm insertion

Supported input types:

• <textarea> elements

• <input type="text">

• <input type="email">

• <input type="search">

• <input type="url">

ContentEditable elements (used by many rich text editors)

Tips and tricks:
Works on most websites with standard input fields
Text is inserted at the cursor position, not replacing existing text
If the field already has text, it inserts at the cursor
You can also use the "Copy" button and paste manually
Works in AI chat interfaces, forms, text editors, and more

Troubleshooting:
Drag doesn't work: Ensure you're clicking on the card itself, not the buttons
Drop doesn't work: The target field might not support drag & drop — use "Copy" instead
Text doesn't insert: Some websites block programmatic text insertion — use copy/paste
Outline doesn't appear: The field might not be a standard input — try a different field

Alternative methods:
Copy button: Click "Copy" on any prompt card, then paste (Ctrl+V / Cmd+V)
Context menu: Right-click in an input field → "Insert Saved Prompt" → Select a prompt
Manual copy: Select the prompt text in the sidebar and copy it

Best practices:
Use drag & drop for quick insertion
Use copy for fields that don't support drag & drop
Use the context menu when working in editable areas
Test on the website first to confirm it works

The extension has limits to ensure performance and compatibility.

Character limits:

Title:
Minimum: 1 character
Maximum: 200 characters
Validation: Must not be empty and cannot exceed 200 characters

Prompt Body:
Minimum: 0 characters (can be empty)
Maximum: 10,000 characters
Validation: Cannot exceed 10,000 characters
Note: The extension supports prompts up to 10KB for drag & drop insertion

Tags:
Per tag: Maximum 50 characters
Number of tags: Unlimited (but practical limits apply)
Format: Comma-separated values (e.g., "tag1, tag2, tag3")
Validation: Each tag is trimmed and validated individually

Storage limits:
Local storage:
Firefox browser.storage.local has a limit of approximately 10MB
With 10,000-character prompts, you can store roughly 1,000 prompts locally
Actual capacity depends on prompt sizes, tags, and metadata

Google Sheets:
Google Sheets supports up to 10 million cells
With 5 columns (Title, Prompt, Tags, Last Updated, ID), you can store roughly 2 million prompts
Practical limits are much lower due to performance
Recommended: Keep under 10,000 rows for best performance
Notion:
Notion databases have no hard limits, but performance degrades with very large databases
Recommended: Keep under 10,000 entries for best performance
Each prompt is a database entry with multiple properties

Performance considerations:
Search and filter: Works best with under 1,000 prompts
Sync speed: Slower with very large collections (1,000+ prompts)
Loading time: Sidebar loads faster with fewer prompts
Memory usage: More prompts use more browser memory

Best practices:
Keep prompts concise — split very long prompts if needed
Use tags to organize — easier to filter large collections
Archive old prompts — delete or move to a separate sheet/database
Regular cleanup — remove unused or duplicate prompts
Split large collections — use multiple sheets/databases if needed

Context menu limits:
Only the 20 most recently updated prompts appear in the context menu
This keeps the menu manageable
All prompts are still accessible in the sidebar

Sync limits:
No hard limits on sync operations
Very large syncs (1,000+ prompts) may take longer
Network speed affects sync time
Google Sheets API has rate limits (usually not an issue for normal use)

If you hit limits:
Title too long: Shorten the title to 200 characters or less
Body too long: Split into multiple prompts or trim content
Tag too long: Shorten individual tags to 50 characters or less
Storage full: Delete unused prompts or use cloud sync
Performance slow: Reduce prompt count or use filtering/search

The context menu lets you quickly save highlighted text as prompts and insert saved prompts.

Accessing the context menu:
Right-click anywhere on a webpage
Look for "Save as Prompt" and "Insert Saved Prompt" options

Saving highlighted text as a prompt:
Highlight the text you want to save
Right-click on the highlighted text
Select "Save as Prompt"
The extension sidebar opens (or a popup window) with the form pre-filled:
Title: Auto-generated from the first 50 characters of the text
Body: The highlighted text (up to 50,000 characters)
Tags: Empty (you can add tags)
Review and edit the pre-filled information
Add tags if desired
Click "Save Prompt"
The prompt is saved and synced (if auto-sync is enabled)

Inserting saved prompts via context menu:
Click in any text input field or textarea
Right-click in the field
Select "Insert Saved Prompt"
A submenu shows your 20 most recently updated prompts
Click the prompt you want to insert
The prompt text is inserted at the cursor position

Context menu options:
"Save as Prompt":
Available when text is selected
Works on any webpage
Pre-fills the form with selected text
Opens sidebar or popup window
"Insert Saved Prompt":
Available in editable fields (input, textarea, contentEditable)
Shows 20 most recent prompts
Inserts prompt text at cursor position
Works in most text input fields

Tips and tricks:
The context menu appears on all webpages
Selected text is automatically trimmed
Very long selections (50,000+ characters) are truncated
The sidebar opens automatically when saving
If the sidebar is already open, the form is pre-filled there
Prompt titles in the menu are truncated to 50 characters for readability

Troubleshooting:
Context menu doesn't appear: Check that the extension is enabled and reloaded
"Save as Prompt" doesn't work: Ensure text is actually selected (highlighted)
"Insert Saved Prompt" doesn't work: Click in an editable field first, or the field may not support insertion
Prompt doesn't insert: Some websites block programmatic insertion — use copy/paste instead
Menu shows old prompts: The menu updates automatically when you save new prompts

Best practices:
Use "Save as Prompt" to quickly capture interesting text
Use "Insert Saved Prompt" for frequently used prompts
Add tags when saving to organize prompts
Review auto-generated titles before saving
Use the sidebar for managing prompts in detail

Limitations:
Only 20 most recent prompts appear in the insert menu
Very long text selections (50,000+ characters) are truncated
Some websites may block context menu functionality
Insertion may not work in some proprietary text editors

Your data privacy and security are important. Here's how the extension handles your data.

Data storage locations:
1. Local browser storage (primary):
All prompts are stored locally in your Firefox browser
Uses Firefox's browser.storage.local API
Data remains on your device
Not accessible by websites or other extensions
Stored in your Firefox profile directory
2. Google Sheets (if connected):
Prompts sync to your Google Sheets account
Stored in spreadsheets you create or select
Subject to Google's privacy policy and terms
You control access and sharing
Encrypted in transit and at rest by Google
3. Notion (if connected):
Prompts sync to your Notion workspace
Stored in databases you create or link
Subject to Notion's privacy policy and terms
You control access and sharing
Encrypted in transit and at rest by Notion

What data is stored:
Locally (browser storage):
Prompt titles, content, and tags
Unique IDs for each prompt
Creation and update timestamps
Authentication tokens (encrypted)
Settings (sync service preferences, sheet/database IDs)
In Google Sheets/Notion:
Same data as local storage (titles, content, tags, IDs, timestamps)
No additional data is stored
What data is NOT stored:
❌ No browsing history
❌ No personal information (except what you enter in prompts)
❌ No tracking or analytics data
❌ No data sent to the extension developer
❌ No data shared with third parties (except Google/Notion when you sync)
❌ No cookies or tracking pixels

Privacy features:
1. Local-first storage:
All prompts stored locally first
Cloud sync is optional
You control what syncs
2. No developer access:
The extension developer has no access to your data
No servers or databases owned by the developer
No data collection or analytics
3. Your cloud accounts:
Data syncs to your own Google Sheets/Notion accounts
You control access and sharing
Standard cloud security applies
4. Encrypted connections:
All API communication uses HTTPS
OAuth tokens transmitted securely
Data encrypted in transit

Security measures:
1. Authentication:
Google OAuth 2.0 for secure authentication
Notion Integration tokens for API access
Tokens stored locally and encrypted by Firefox
Google tokens expire after 1 hour (auto-refresh)
Notion tokens don't expire (can be revoked in Notion)
2. Permissions:
Extension only requests necessary permissions
identity - For Google OAuth
storage - For local prompt storage
contextMenus - For right-click menu
activeTab - For content script functionality
Content script runs on all pages but only reads text you explicitly select
3. Data access:
Only you can access your local data
Cloud data access controlled by your Google/Notion account settings
No backdoors or developer access

Your rights and controls:
You can:
View all stored data in the extension sidebar
Edit or delete prompts at any time
Disconnect from sync services
Uninstall the extension (local data is deleted)
Export data by syncing to Google Sheets/Notion
Control sharing in Google Sheets/Notion
Data deletion:
Delete individual prompts in the extension
Disconnect from sync services (cloud data remains)
Uninstall the extension (local data deleted)
Delete data directly in Google Sheets/Notion

Important notes:
Local data is stored in your Firefox profile — uninstalling the extension deletes it
Cloud data persists even if you disconnect or uninstall
Back up important prompts by syncing to cloud storage
Review Google/Notion privacy policies when using those services
Use strong account security for Google and Notion accounts

Privacy policy:
See the full Privacy Policy document for detailed information
Contact: support@ai-prompt-saver.com for privacy questions

Best practices:
Sync important prompts to cloud storage for backup
Use strong passwords for Google/Notion accounts
Enable two-factor authentication for Google/Notion
Review sharing settings in Google Sheets/Notion
Regularly back up prompts by syncing
Be cautious about storing sensitive information in prompts