Creating Pastes
Pastes are the core of SnipShare. A paste is a named, versioned collection of one or more code files - similar to GitHub Gist.
Getting to the Create Form
Section titled “Getting to the Create Form”Three ways to reach the create page:
- Navigate to
/pastes/create/directly - Click + New Paste on the pastes archive page
- Click + Add Snip on your BuddyPress profile (when integration is enabled)
You must be logged in to create a paste.
Filling in the Form
Section titled “Filling in the Form”A descriptive name for your paste. Optional but strongly recommended - it’s what appears in the archive and search results. Maximum 255 characters.
Description
Section titled “Description”A brief explanation of what the code does or why it exists. Shown below the title in listings. Optional.
Files (Code Editor)
Section titled “Files (Code Editor)”Each paste has at least one file tab. The file tab shows:
- Filename: e.g.,
index.php,styles.css. Used for the download filename and raw URL. - Language: Select from 20+ options for syntax highlighting. Common choices: PHP, JavaScript, TypeScript, Python, CSS, HTML, SQL, Bash, JSON, YAML, Markdown, plaintext.
- Content: The CodeMirror 6 editor. Supports:
- Syntax highlighting per selected language
- Line numbers (if enabled in Settings)
- Light/dark/auto theme (per Settings)
- Standard keyboard shortcuts (Tab for indent, Ctrl+Z for undo)
Adding More Files
Section titled “Adding More Files”Click + Add File to add another file tab (up to the limit set in Settings → General). Each file has its own filename, language selector, and editor. Multi-file pastes are like GitHub Gists - all files are part of the same paste and share the same URL.
To remove a file tab, click the × on the tab. The paste must always have at least one file.
Paste Options
Section titled “Paste Options”Visibility
Section titled “Visibility”| Option | Who can see it |
|---|---|
| Public | Everyone; appears in the archive and tag listings |
| Unlisted | Only people with the direct link; does not appear in any listing |
| Private | Only the paste owner |
Expiration
Section titled “Expiration”Set an automatic expiry time. After expiration, the paste’s status changes to expired and it is no longer accessible.
Options: Never, 1 Hour, 1 Day, 1 Week, 1 Month
Requires Paste Expiration to be enabled in Settings → General.
Password Protection
Section titled “Password Protection”Enter a password to lock the paste. Visitors must enter the correct password to view the content. Password-protected pastes are not exposed via oEmbed.
Requires Password Protection to be enabled in Settings → General.
Burn After Read
Section titled “Burn After Read”When checked, the paste is permanently deleted (status set to expired) after the first person views it. Use for one-time secrets or temporary code snippets.
Requires Burn After Read to be enabled in Settings → General.
Comma-separated tags. Tags are used for categorisation and discovery - e.g., /pastes/tag/php/. New tags are created automatically. Existing tags have their count incremented.
Requires Tags to be enabled in Settings → General.
After Creating
Section titled “After Creating”After submitting, you’re taken to the single paste view.
From here you can:
- Copy the URL to share
- View raw at
/paste/{hash}/raw/ - Download the files at
/paste/{hash}/download/ - Fork: clone into your own account
- Star: save to your starred list
- Edit: opens the edit form, creates revisions
- Report: flag for moderation (if content reporting is enabled)
Limits
Section titled “Limits”| Limit | Default | Where to change |
|---|---|---|
| Max paste size | 100 KB total | Settings → General |
| Max files per paste | 10 | Settings → General |
| Max pastes per user | Unlimited | Settings → General |
| Rate limit | 20 per hour | Settings → Permissions |