Document Embedding in Taskboards

Keep all your project documentation connected to your tasks with Waymaker's document embedding feature. Link and preview Google Docs, PDFs, Figma designs, and other files directly within taskboards for centralized access and seamless collaboration.

Overview

Document embedding transforms your taskboards from simple task lists into comprehensive project hubs. Instead of switching between multiple tools and tabs, team members can access all relevant documentation directly from the task card.

Key Benefits

Centralized Access All project documentation lives alongside the tasks it supports, eliminating context switching and reducing time spent searching for files.

Live Previews Preview embedded documents without leaving the taskboard, with support for multiple file formats and real-time updates.

Maintained Context Documents remain connected to their tasks throughout the project lifecycle, preserving valuable context and decision history.

Collaboration Efficiency Team members can access, review, and edit documents without leaving their workflow, reducing friction in the collaboration process.

Supported Document Types

Waymaker supports embedding and previewing a wide range of document types to accommodate different workflows and tools.

Google Workspace Documents

Google Docs Embed word processing documents with full preview capabilities. Team members can view the document inline and click through to edit with proper Google permissions.

Google Sheets Link spreadsheets for budget tracking, data analysis, or resource planning. Embedded sheets display with scrollable preview and direct access to full spreadsheet functionality.

Google Slides Attach presentation decks to tasks for design reviews, strategy presentations, or project proposals with thumbnail and full-screen preview options.

Google Forms Connect forms for surveys, feedback collection, or approval workflows directly to relevant tasks.

Microsoft Office Documents

Word Documents Embed .docx files with preview support for specifications, reports, and documentation. Documents stored in OneDrive or SharePoint maintain live sync.

Excel Spreadsheets Link .xlsx files for budgets, timelines, or data analysis with preview capabilities and direct editing access.

PowerPoint Presentations Attach .pptx files with slide preview and full presentation access for stakeholder reviews and team presentations.

PDF Documents

Standard PDFs Embed PDF files with inline preview, search capabilities, and annotation support for contracts, invoices, reports, and printable deliverables.

Interactive PDFs Support for PDFs with forms, links, and interactive elements maintains full functionality when embedded.

Design and Prototype Files

Figma Embed Figma design files and prototypes with live preview. Changes to the Figma file automatically reflect in the embedded preview.

Adobe XD Link Adobe XD prototypes and design specifications with preview support and direct access to editing environment.

Sketch Cloud Connect Sketch designs shared via Cloud with thumbnail previews and design spec access.

Miro Boards Embed Miro whiteboards for brainstorming, mapping, and workshop outputs with interactive preview.

Code and Technical Documentation

GitHub Files Link to specific files, pull requests, or documentation in GitHub repositories with markdown preview support.

Code Snippets Embed code files with syntax highlighting for technical specifications or implementation details.

API Documentation Connect OpenAPI/Swagger documentation for API development tasks with interactive preview.

Video and Media

Video Files Embed video demonstrations, tutorials, or recorded meetings from YouTube, Vimeo, Loom, or direct uploads.

Image Files Attach images with inline preview for mockups, screenshots, diagrams, and reference materials.

How to Embed Documents

Adding documents to tasks is straightforward with multiple methods to accommodate different workflows.

Method 1: Direct URL Embedding

The quickest way to embed a document is pasting a URL directly into the task.

Step 1: Copy Document URL Navigate to your document and copy the sharing URL from your browser or the share dialog.

Step 2: Open Task Details Click on the task card to open the detailed view.

Step 3: Add to Attachments In the Attachments section, click "Add Link" or paste the URL directly into the attachment field.

Step 4: Automatic Detection Waymaker automatically detects the document type and generates an appropriate preview based on the URL format.

Method 2: File Upload

For documents stored locally, upload them directly to the task.

Step 1: Open Attachment Dialog In the task details, click "Upload File" in the Attachments section.

Step 2: Select Files Choose one or more files from your computer. Supported formats include PDF, Word, Excel, PowerPoint, and common image formats.

Step 3: Wait for Processing Files upload and process automatically. Preview generation typically completes within seconds for standard documents.

Step 4: Verify Preview Once processing completes, verify the preview displays correctly and contains the expected content.

Method 3: Integration Picker

Connect documents from integrated cloud storage services.

Step 1: Open Integration Picker Click the integration icon in the Attachments section to access connected services.

Step 2: Select Service Choose from Google Drive, Dropbox, OneDrive, or other connected services.

Step 3: Browse and Select Navigate through your files and select the document to embed. You can select multiple files simultaneously.

Step 4: Confirm Permissions Review and confirm sharing permissions to ensure team members can access the embedded documents.

Drag and Drop

The fastest method for multiple documents or images.

Step 1: Select Files Open your file browser and select the documents you want to attach.

Step 2: Drag to Task Card Drag the selected files directly onto the task card or into the attachment area of the task details panel.

Step 3: Drop to Upload Release to upload. Multiple files process simultaneously with progress indicators for each.

Preview Capabilities

Waymaker's preview system provides quick access to document content without requiring full application launches.

Inline Preview

Embedded Viewer Most document types display in an embedded viewer within the task details panel. The viewer includes:

• Scrollable content area
• Zoom controls for detailed inspection
• Page navigation for multi-page documents
• Download option for offline access
• Full-screen mode for focused review

Smart Rendering The preview system automatically adjusts based on document type and size, balancing preview quality with load performance.

Preview Limitations

Size Restrictions Documents over 100MB may show thumbnail previews only, with a link to open in the native application.

Format Support Some specialized file formats may display as downloadable links rather than inline previews. Common formats like PDF, images, and Google Workspace files always support preview.

Permission Requirements Previews respect document permissions. If a team member lacks access to the source document, they'll see a permission request prompt instead of the preview.

Editing Embedded Documents

Seamlessly transition from viewing to editing with preserved context.

Edit in Place

Google Workspace Documents Click "Edit" on any embedded Google document to open it in a side panel within Waymaker. This maintains visibility of task details while editing.

Real-time Collaboration Multiple team members can edit simultaneously with changes syncing in real-time, just like working directly in Google Docs.

Auto-save and Sync All changes save automatically to the source document with no manual sync required.

Open in Application

External Editing Click "Open in [Application]" to launch the full editing environment in a new tab while maintaining your position in the taskboard.

Return Context When you return to Waymaker, the updated document preview reflects your changes automatically.

Version History

Track Changes Access the complete version history of embedded documents directly from the task attachment.

Restore Previous Versions Revert to earlier versions if needed without leaving the taskboard interface.

Change Attribution See who made specific changes and when for full audit trail capabilities.

Permissions and Access Control

Managing document access within taskboards ensures the right people have the right level of access.

Inherited Permissions

Source Document Permissions Embedded documents maintain the permissions set in their source application. If a document is private in Google Drive, only users with access can view the preview in Waymaker.

Automatic Sync Permission changes made in the source application automatically reflect in Waymaker previews without manual updates.

Task-Level Sharing

Share with Task When sharing a task with team members, Waymaker prompts you to grant access to embedded documents if recipients don't already have it.

Bulk Permission Grants Select "Grant access to all attachments" when adding team members to automatically provision access to all embedded documents.

Guest Access Considerations

Guest User Limitations Guest users can only access embedded documents if they're granted explicit permission in the source application.

Public Link Sharing For maximum guest accessibility, consider using public sharing links for documents that don't contain sensitive information.

Organization Policies

Domain Restrictions If your organization has domain-restricted sharing enabled in Google Workspace or Microsoft 365, those restrictions apply to embedded documents.

Data Loss Prevention (DLP) DLP policies from your document management system extend to embedded documents in Waymaker.

Best Practices

Maximize the value of document embedding with these proven practices.

Organization Strategies

Consistent Naming Use clear, descriptive names for embedded documents that indicate their purpose and content. Include version numbers or dates when appropriate.

Logical Grouping Group related documents together in the attachment list. Most critical or frequently accessed documents should appear first.

Document Type Labels Add labels or prefixes to document names indicating type (SPEC-, DESIGN-, BUDGET-) for quick identification.

Maintenance Practices

Regular Audits Periodically review attached documents to ensure all links remain valid and content is current.

Archive Old Versions When superseding documents with new versions, archive rather than delete old versions to maintain project history.

Remove Duplicates Consolidate duplicate attachments to reduce clutter and prevent confusion about which version is authoritative.

Performance Optimization

Link vs. Upload Strategy Link to documents stored in cloud services rather than uploading copies to maintain single sources of truth and reduce storage usage.

Preview-Friendly Formats When creating documents specifically for taskboard embedding, choose formats that preview well (PDF, Google Docs) over proprietary formats with limited preview support.

Size Management Keep individual documents under 50MB for optimal preview performance. Break large documents into logical sections if needed.

Collaboration Tips

Edit Notifications Enable edit notifications on critical embedded documents so team members know when important changes occur.

Comment Integration Use document comments for detailed feedback and task comments for high-level discussion to maintain appropriate context.

Access Verification Before critical meetings or deadlines, verify all stakeholders have access to relevant embedded documents.

Troubleshooting

Solutions to common document embedding issues.

Preview Not Loading

Verify Permissions Confirm you have view access to the source document. Try opening the document directly from its source application.

Check Internet Connection Preview generation requires active internet connectivity. Verify your connection is stable.

Clear Browser Cache Cached preview data can sometimes become corrupted. Clear your browser cache and refresh the page.

File Format Support Verify the document format is supported for preview. Check the supported formats list above.

Edit Access Issues

Permission Levels Editing requires edit permissions in the source application. View-only access won't allow editing even if the preview displays.

Account Matching Verify you're signed into the same Google/Microsoft account in Waymaker that has edit access to the document.

Application Compatibility Some documents may require opening in the native application rather than editing in-place.

Broken Links

Updated URLs If a document was moved or renamed, the embedded link may break. Update the link with the new URL.

Deleted Documents Verify the source document still exists and wasn't deleted or moved to trash.

Permission Changes If permissions were revoked after embedding, the link appears broken. Verify and restore access.

Sync Delays

Refresh Preview If recent changes don't appear, manually refresh the preview using the refresh icon in the preview controls.

Cache Duration Preview caches typically refresh every 15 minutes. Major changes may require manual refresh for immediate visibility.

Service Status Check if the source service (Google Drive, OneDrive) is experiencing outages affecting preview generation.

Advanced Features

Power user capabilities for document embedding.

Bulk Operations

Multi-Document Upload Upload or link multiple documents simultaneously using drag-and-drop or multi-select in the file picker.

Batch Permission Updates Update sharing permissions for multiple embedded documents at once through the bulk actions menu.

Template Integration

Document Template Library Create reusable task templates that include standard document attachments for consistent project setup.

Auto-attach on Creation Configure task templates to automatically attach specific documents when tasks are created from that template.

Search and Filter

Attachment Search Search across all embedded documents in a taskboard to quickly locate specific files or content.

Filter by Type Filter task views to show only tasks with specific attachment types (PDFs only, Google Docs only, etc.).

API Access

Programmatic Embedding Use Waymaker's API to programmatically attach documents to tasks as part of automated workflows.

Webhook Notifications Receive webhook notifications when documents are added or updated on specific tasks.

Integration Examples

Real-world scenarios demonstrating effective document embedding.

Product Development

Design Specifications Embed Figma designs and product requirement documents directly on feature tasks so developers have immediate access to specifications.

Testing Documentation Attach test plans and bug reports to QA tasks for comprehensive testing context.

Marketing Campaigns

Creative Briefs Link campaign briefs and creative assets to campaign tasks for centralized creative management.

Performance Reports Embed analytics dashboards and performance reports to track campaign effectiveness alongside execution tasks.

Client Projects

Proposals and Contracts Attach signed proposals and contracts to project kickoff tasks for easy reference.

Deliverables Link final deliverable documents to completion tasks for organized client handoff.

Financial Planning

Budget Spreadsheets Embed budget tracking spreadsheets on financial planning tasks for real-time visibility into spending.

Invoice Documentation Attach invoices and receipts to payment tasks for complete financial record-keeping.

Getting Started

Begin using document embedding in your taskboards today.

Step 1: Identify Key Documents Review your current projects and identify the 3-5 most frequently accessed documents that would benefit from taskboard embedding.

Step 2: Test Embedding Methods Try each embedding method (URL, upload, integration picker) to find your preferred workflow.

Step 3: Set Up Permissions Verify team members have appropriate access to embedded documents and establish permission management practices.

Step 4: Create Standards Document your team's conventions for naming, organizing, and maintaining embedded documents.

Step 5: Scale Gradually Start with one project or board, refine your approach, then expand to additional teams and workflows.

Next Steps

• File Management - Learn comprehensive file management strategies
• Calendar Integration - Connect taskboards with your calendar
• Task Automation - Automate document-related workflows
• Team Collaboration - Manage team access to embedded documents