# JavaScript and the 1Extn Script Manager

Documentation last reviewed: 2026-10-13

1Extn lets users create and save personal webpage tools for Safari. These tools use editable JavaScript to change how a webpage looks or works.

## Where to Start

Open My Scripts in 1Extn. Choose a starter script, use built-in script help, import compatible code, or add your own JavaScript.

1Extn works with or without Apple Intelligence.

## Supported Inputs

- Plain JavaScript
- Compatible userscript-style code
- Bookmarklet-style code
- Trusted HTTPS `.js` links
- Trusted HTTPS `.user.js` links

Compatibility can depend on the code, the target webpage, Safari behavior, and the capabilities exposed by 1Extn.

## Managing Saved Tools

Users can create, edit, save, search, organize, import, export, back up as needed, and share scripts. Review imported or generated code before running it.

## Manual Mode

Manual mode runs one selected script at a time. It is appropriate when the user wants to decide exactly when a webpage change occurs.

## Auto Run

Auto Run is optional. It can run multiple trusted scripts automatically on Safari websites selected by the user. Auto Run remains off until configured.

Only enable Auto Run for code that is understood and trusted. Website changes can cause a previously working script to stop working or behave differently.

## Example Outcomes

- Hide distracting page elements.
- Adjust colors, fonts, spacing, or layout.
- Add a useful control or behavior to a webpage.
- Simplify a repeated page interaction.
- Apply a trusted change automatically on selected websites.

## Script Library

The official website provides optional `.1extnscript` downloads that open in 1Extn for review and saving. Imported scripts keep Auto Run off until the user chooses otherwise.

Script Library documentation: https://1extn.app/docs/script-library.md

## Scope

1Extn provides user-configured webpage scripting inside Safari. It is not unrestricted robotic browser automation and does not convert arbitrary browser extensions into Safari extensions.

## Related Documentation

- Userscript workflows: https://1extn.app/docs/userscripts.md
- Use cases: https://1extn.app/docs/use-cases.md
- Features: https://1extn.app/docs/features.md
