Site Sparks Help & FAQ

Site Sparks Help & FAQ

Find answers to common questions about Site Sparks. 

1. What is a UserScript?

A UserScript is a small JavaScript program that changes how a website looks or behaves in your browser.

Examples: 
  1. Hide YouTube Shorts
  2. Remove promoted posts
  3. Disable autoplay videos
  4. Add dark mode
  5. Remove cookie popups
Notes
  1. Scripts run only in your browser
  2. They don’t change the site for others
  3. They don’t affect the website server

2. What does a UserScript look like?

Each script includes a metadata header followed by JavaScript code.

Quote
// ==UserScript==
// @name          My Script
// @description   What this script does
// @match         https://example.com/
// @exclude match https://example.com/admin/
// @run at        document end
// @noframes
// ==/UserScript==

(function() {
  'use strict';
  console.log('Script loaded!');
})();

3. What metadata tags are supported?

Tag
 Required
 Description
 @name
 Yes
 Script name (max 50 characters)
 @description
 No
 Script description (max 250 characters)
 @match
 Yes
 URL patterns where script runs
 @exclude match
 No
 URL patterns to exclude
 @run at
 No
 document start or document end
 @noframes
 No
 Prevents running in iframes

4. Do I need programming knowledge?

Yes, to create custom scripts. Importing ready-made scripts is easier if you don’t code.

5. How many scripts can I have?

Up to 25 scripts per profile.

6. Do scripts sync across devices?

Yes, if you’re signed into your browser.

7. Script Size Limits

Limit
 Value
 Maximum source code size
 140 KB
 Maximum import file size
 150 KB
 Maximum name length
 50 characters
 Maximum description length
 250 characters

8. Script not running?

  1. Ensure the script is enabled
  2. Check URL match patterns
  3. Try different injection timing
  4. Look for syntax errors
  5. Some sites block scripts via security policies

9. Website looks broken?

  1. Disable the suspected script
  2. Test scripts one by one
Notes
Multiple scripts may modify the same page elements

10. What to do if the script stopped working?

Websites change over time. Update your scripts.

11. Can’t save or import?

  1. Name too long (over 50 chars)
  1. Code too large (over 140 KB)
  1. Import file must be .js and under 150 KB

12. Debugging limitation

To debug:
  1. Write and test your script in a desktop browser’s developer console
  2. Use console.log() for testing
  3. Once working, import or paste it into Site Sparks
  4. If issues appear on mobile, replicate them on desktop.
Notes
Site Sparks on mobile does not provide access to a developer console or error logs.

13. On which pages will a script run?

A script runs on every URL listed in the Allowed Sites field. If multiple patterns are added, the script runs on any page matching at least one.

14. What are blocked sites?

Blocked sites are URLs where the script is excluded from running. Even if a page matches an allowed pattern, it will not run if it also matches a blocked site pattern.

15. What is injection timing?

Injection timing controls when your script runs:
  1. document end (default): After page content loads
  2. document start: Before page content loads
Use document start if you need to modify content before it renders.

16. What does "Main Frame Only" mean?

  1. Disabled (default) : Script also runs inside iframes
  2. Enabled: Script runs only on the main page
Notes
Keep this turned  off if you want scripts to affect embedded content like videos or widgets.

17. Can multiple scripts run on the same page?

Yes. Each script runs in its own isolated environment. If multiple scripts match a page, they all run.

18. How do I use multiple URL patterns or exclude certain pages?

You can add multiple entries in:
Allowed Sites — Where scripts should run
Blocked Sites — Pages to exclude
This lets you target broad sites while excluding specific pages.