Skip to main content

Share Transcripts

Scriptix makes it easy to share transcripts with colleagues, clients, and stakeholders without requiring them to create accounts or log in. Share links provide instant access to your transcripts for viewing and collaborative editing.

Sharing Methods Overview​

Scriptix offers two sharing methods:

MethodAccess TypeAuthentication RequiredBest For
Magic LinkToken-based URLNoQuick sharing, external stakeholders, clients
Email ShareMagic link sent via emailNoDirect sharing with specific people

Both methods use secure, unique tokens embedded in URLs that grant access without requiring recipients to create Scriptix accounts.

What Can Be Shared?​

You can share:

  • Transcripts - Speech-to-text documents with audio/video
  • Captions - Subtitle/caption documents with timing
  • In-progress documents - Documents still being edited
  • Finalized documents - Locked, approved documents

Magic links are shareable URLs that grant access to your transcript or caption without authentication.

  1. Generate Link - Create a unique token-based URL for your document
  2. Share URL - Send the link via email, chat, or any communication method
  3. Recipients Click - Anyone with the link can access the document
  4. No Login Required - Recipients view and edit without creating an account
  5. Redirects Authenticated Users - If a recipient is already logged into Scriptix, they're redirected to the authenticated editor
https://app.scriptix.io/transcripts/shared/{sessionId}/{documentId}/{token}
https://app.scriptix.io/captions/shared/{sessionId}/{documentId}/{token}

URL Components:

  • sessionId - Unique identifier for the transcription session
  • documentId - Unique identifier for the document
  • token - Secret token that grants access to the document

Step 1: Open Your Document

  1. Navigate to the transcript or caption in the editor

Step 2: Access Share Button 2. Look for the "Magic Link" button in the toolbar 3. Icon: WandSparkles (✨) icon 4. Located near Export and Translate buttons 5. Button is disabled if document is finalized

Step 3: Generate Link 6. Click the "Magic Link" button 7. A share dialog opens 8. Click "Generate Link" or the button automatically generates on open 9. API creates a unique magic link instantly

Success:

  • Toast notification: "Magic link generated successfully"
  • Link appears in the dialog, ready to copy

Error Handling:

  • Validation errors displayed if request fails
  • Generic error: "Failed to generate the magic link"

The Share Dialog​

Dialog Contents:

1. Magic Link Display Section:

  • Shows the full generated URL
  • Text is word-wrapped for readability
  • Link is selectable for manual copying

2. Copy Button:

  • Icon: ClipboardCopy (📋)
  • Label: "Copy Link"
  • Uses navigator.clipboard.writeText() to copy
  • Toast notification on success: "Link copied to clipboard"
  • Toast error on failure: "Failed to copy the link"

3. Email Sharing Section (See Email Sharing below)

4. Footer:

  • Close button to dismiss modal

Copy to Clipboard:

  1. Click the "Copy Link" button in the share dialog
  2. The URL is copied to your clipboard
  3. Paste it anywhere you want to share

Sharing Methods:

  • Email the link directly to recipients
  • Post in chat applications (Slack, Teams, Discord)
  • Embed in documents or wikis
  • Share via SMS or messaging apps
  • Include in project management tools

Email Sharing​

Send magic links directly via email from within Scriptix.

How Email Sharing Works​

  1. Open Share Dialog - Click Magic Link button
  2. Enter Recipients - Add email addresses
  3. Compose Message - Write optional custom message
  4. Send - Scriptix sends emails with the magic link
  5. Recipients Receive - Email contains link and your message
  6. Click to Access - Recipients click link to open document

Sending via Email​

Location: Within the Magic Link share dialog

Step 1: Generate Magic Link First

  1. Click "Magic Link" button to open share dialog
  2. Link is automatically generated

Step 2: Enter Email Addresses 3. Scroll to "Send via Email" section 4. To: field - Text area for email addresses 5. Enter multiple addresses separated by:

  • Commas: john@example.com, sarah@example.com
  • Semicolons: john@example.com; sarah@example.com
  • Newlines/line breaks
  • Spaces

Email Validation:

  • Regex pattern: /^[^\s@]+@[^\s@]+\.[^\s@]+$/
  • Invalid emails shown with error styling
  • Must fix invalid addresses before sending

Step 3: Compose Message (Optional) 6. Message: field - Text area (3 rows) 7. Character limit: 500 characters maximum 8. Live character counter shows remaining: X / 500 9. Optional - can send without a message

Step 4: Send 10. Click "Send" button (Mail icon) 11. Button shows loading state while sending 12. API sends emails to all valid addresses

Success Messages:

  • Single recipient: "Magic link sent to {email}"
  • Multiple recipients: "Magic link sent to {count} recipients"
  • Generic: "Magic link email sent successfully."
  • Also shows count: "Sent magic link to X recipients" below send button

Error Handling:

  • Invalid email addresses highlighted in red
  • Error toast: "Failed to send magic link email"
  • Validation errors shown per field

Email Content​

Recipients receive an email containing:

  • Your custom message (if provided)
  • The magic link URL
  • Instructions for accessing the document

Note: Exact email template is determined by the server.

Email Share Best Practices​

Professional Messages:

  • Explain what the document is about
  • Specify if you need feedback or review
  • Set deadlines if applicable
  • Provide context about the content

Example Message:

Hi Team,

Please review this transcript from yesterday's client meeting.
Let me know if you see any errors or have comments by Friday.

Thanks!

Multiple Recipients:

  • Send to entire team at once
  • Everyone receives the same magic link with same token
  • All recipients have collaborative editing access
  • Coordinate to avoid simultaneous edits to same sections

Accessing Shared Documents (Recipient View)​

When someone receives a magic link:

Step 1: Receive Link

  • Via email, chat, or other method

Step 2: Click Link

  • Open the URL in a web browser
  • Link format: /transcripts/shared/{sessionId}/{documentId}/{token}

Step 3: Loading

  • Page shows loading spinner (ScaleLoader, blue color: #5794f6)
  • Fetches session and document data using the token

Step 4: Validation

  • If token is invalid: Session Not Found or Document Not Found error page
  • If logged in: Automatically redirected to authenticated editor
  • If valid and not logged in: Shared editor loads

Available Features​

What Recipients Can Do:

  • View the full transcript/caption
  • Play/pause media (if available)
  • Click timestamps to navigate
  • Scroll through content
  • Use search functionality
  • Edit text (collaborative access enabled)
  • Add/edit/delete comments
  • Apply text formatting (bold, italic, underline, strikethrough)
  • Use keyboard shortcuts
  • Change speaker labels
  • Split and merge utterances

Editing Capabilities:

  • Auto-save functionality (120-second interval)
  • LocalStorage backup for offline persistence
  • Clear text: PUT .../clear_text
  • Reset to original: PUT .../reset_to_original

Status Indicator:

  • Shows document status (Finalized / Editable)
  • Green pill with CheckCircle2 icon = Finalized
  • Amber pill with Pencil icon = Editable
  • Can toggle finalization status (if permitted)

Limited Features​

What Recipients Cannot Do:

  • Access other sessions or documents in the workspace
  • Create new transcription or caption sessions
  • View workspace file list
  • Change sharing permissions
  • Delete the document
  • Access organization settings
  • View billing or account information
  • Translate documents (export/translate features may be limited)

Export Limitations:

  • Export may be disabled or limited for shared links
  • Depends on organization settings and document configuration
  • Some export formats may not be available

Security and Privacy​

Magic Links Are:

  • Unique - Each link contains a randomly generated token
  • Long - Tokens are cryptographically secure random strings
  • Unguessable - Impossible to predict or enumerate
  • Revocable - Server-side validation can be disabled (token becomes invalid)

Magic Links Are NOT:

  • Password-protected - No password required by default
  • Time-limited - Links don't expire automatically (unless organization sets policies)
  • Single-use - Same link can be used multiple times

Best Practices for Secure Sharing​

  1. Share Links Privately

    • Send via secure channels (email, private chat)
    • Don't post publicly on social media or websites
    • Avoid sharing in public forums or unencrypted channels

  2. Be Mindful of Recipients

    • Only share with people who need access
    • Remember that anyone with the link can access the document
    • Recipients can potentially forward the link to others

  3. Finalize When Appropriate

    • Finalize documents when editing is complete
    • Finalized documents prevent further sharing but existing links remain valid
    • Useful for marking documents as "approved" or "final"

  4. Monitor Document Changes

    • Check document history for unexpected edits
    • Be aware of who you've shared with
    • Coordinate editing sessions to avoid conflicts

Sensitive Content Guidelines​

For highly confidential transcripts:

Recommended Practices:

  • Consider not using magic links for highly sensitive content
  • Use organization-based sharing (invite users to your organization)
  • Rely on internal authentication rather than public links
  • Monitor who has access

Avoid:

  • Sharing links in public or semi-public forums
  • Posting links where they can be indexed by search engines
  • Leaving sensitive content accessible indefinitely

Document Status and Finalization​

Finalized vs. Editable​

Editable Status:

  • Document can be edited by shared users
  • Magic Link button is enabled (can generate/share new links)
  • Amber pill with Pencil icon
  • Changes are saved automatically

Finalized Status:

  • Document is marked as "complete" or "approved"
  • Magic Link button is disabled (cannot generate new links while finalized)
  • Green pill with CheckCircle2 icon
  • Existing magic links remain valid
  • Recipients can still view and edit via existing links

Toggling Status:

  • Use the Finalized/Editable toggle in the toolbar
  • Status changes affect whether new links can be generated

Collaboration Features​

Simultaneous Editing​

Real-Time Collaboration:

  • Multiple users can edit the same document simultaneously
  • Changes are saved via auto-save mechanism (every 120 seconds)
  • Last edit wins (no conflict resolution)

Best Practices:

  • Coordinate who edits which sections
  • Use comments to communicate changes
  • Avoid editing the same paragraph simultaneously
  • Review changes after collaborative sessions

LocalStorage Auto-Save​

Offline Persistence:

  • Shared editors save to browser's localStorage
  • Functions: saveTranscriptToLocalStorage() / loadTranscriptFromLocalStorage()
  • Provides recovery mechanism if connection is lost
  • Data persists across browser sessions until cleared

Comments in Shared Documents​

  • Recipients can add, edit, and delete their own comments
  • Comments are linked to specific text ranges
  • Useful for review and feedback workflows
  • All shared users see all comments

Troubleshooting​

Issue: Recipients cannot access the magic link

Possible Causes:

  • Token is invalid or malformed
  • Document or session was deleted
  • Server-side access revoked
  • Network/connectivity issue

Solutions:

  1. Verify the link was copied completely (full URL)
  2. Try generating a new magic link
  3. Check if document still exists in your workspace
  4. Test the link in an incognito/private browser window
  5. Contact support if issue persists

"Session Not Found" or "Document Not Found"​

Issue: Error page appears when clicking magic link

Cause:

  • Token is invalid
  • Document or session doesn't exist
  • Access was revoked

Solutions:

  • Verify you're using the correct link
  • Generate a new magic link
  • Confirm the document hasn't been deleted

Issue: Magic Link button doesn't work or is disabled

Possible Causes:

  • Document is finalized (button disabled when finalized)
  • Insufficient permissions
  • Organization sharing disabled

Solutions:

  1. Toggle document to "Editable" status first
  2. Check your user role/permissions
  3. Contact organization administrator
  4. Verify sharing features are enabled for your plan

Email Not Received​

Issue: Recipients didn't receive the email with magic link

Possible Causes:

  • Email address typo or invalid format
  • Spam/junk folder
  • Email delivery delay
  • Server-side email issue

Solutions:

  1. Check for email validation errors in red
  2. Ask recipients to check spam/junk folders
  3. Verify email addresses are correct
  4. Try resending
  5. Copy magic link and send manually if email fails

Edits Not Saving in Shared Editor​

Issue: Changes made by shared users don't persist

Possible Causes:

  • Network connectivity issue
  • Auto-save failed
  • Browser localStorage full

Solutions:

  1. Check browser console for errors
  2. Refresh the page
  3. Check network connection
  4. Clear browser cache and reload
  5. Try a different browser

Redirected to Login Page​

Issue: Recipients see a login page instead of shared editor

Cause: Recipients are already logged into Scriptix

Solution:

  • This is expected behavior
  • Logged-in users are automatically redirected to the authenticated editor
  • They access the document through their account, not the magic link
  • Provides better experience for authenticated users

Frequently Asked Questions​

No, magic links work without authentication. Recipients can access documents directly via the link. However, if they are already logged in, they'll be redirected to the authenticated editor.

The current implementation doesn't show a UI for revoking links. Tokens are validated server-side, so contact your organization administrator if you need to revoke access.

Links remain valid indefinitely unless the document/session is deleted or server-side access is revoked. Check with your organization for any expiration policies.

Can recipients download or export shared documents?​

Export functionality in shared editors may be limited based on organization settings. Some export options may not be available to shared link users.

What happens if the original document is deleted?​

The magic link stops working and recipients will see a "Document Not Found" error.

Yes, magic links can be forwarded. Anyone with the link can access the document. Be mindful of who you share with.

Changes are saved periodically (every 120 seconds) and when the page is closed. There's no real-time synchronization like Google Docs, so coordination is recommended.

The current implementation doesn't provide access logs or analytics. Check with your organization for any tracking features.

What's the difference between transcripts/shared and captions/shared?​

  • /transcripts/shared/... loads the shared transcript editor
  • /captions/shared/... loads the shared caption editor
  • Both use the same token-based access system
  • Features and functionality are specific to each editor type

Next Steps​

Related sharing and collaboration features:

Ready to share? Open your document and click the Magic Link button to generate a shareable URL!