Content Import

CrossPostr makes it easy to import your existing content from popular platforms like Google Docs and Notion. The import feature preserves formatting, images, and structure, allowing you to seamlessly migrate your content into CrossPostr's powerful editor.

Overview

The content import feature supports:

• Google Docs: Import documents with full formatting, images, and tables
• Notion: Import pages with blocks, formatting, and embedded content
• Automatic formatting conversion: Content is converted to CrossPostr's editor format
• Image processing: Images are automatically downloaded and processed
• Structure preservation: Headings, lists, tables, and other formatting maintained

Accessing the Import Feature

You can access the import functionality from any content editor page:

1. Navigate to your content dashboard (/dashboard/content)
2. Open an existing article or create a new one
3. Look for the "Import" button in the editor toolbar
4. Click the dropdown arrow to see import options

Notion Import

Prerequisites

Before importing from Notion:

• Have a Notion account with access to the workspace containing your content
• Ensure the pages you want to import are accessible to your account
• Consider the structure of your Notion pages and any nested content

How to Import from Notion

Step 1: Connect to Notion

1. Click "Import from Notion" in the import menu
2. Authenticate with Notion when prompted
3. Grant workspace access to CrossPostr
4. Select the appropriate workspace if you have multiple

Step 2: Browse and Select Pages

1. View all available pages in your workspace
2. Use the search function to find specific pages
3. Browse by recent activity or alphabetical order
4. Click on a page to select it for import
5. Preview page information including title and last edited date

Step 3: Import Your Content

1. Click "Import Selected Page" to begin the process
2. Monitor import progress as blocks are processed
3. Wait for image processing if your page contains images
4. Review the imported content in the editor

Notion Features Supported

Block Types

• Text blocks: Paragraphs with rich formatting
• Heading blocks: H1, H2, H3 with proper structure
• List blocks: Bulleted, numbered, and toggle lists
• Quote blocks: Blockquotes and callouts
• Code blocks: Syntax-highlighted code with language detection

Rich Content

• Tables: Full table support with rows and columns
• Images: Image blocks with captions and alt text
• Dividers: Horizontal rules and section breaks
• Bookmarks: Links with preview information
• Embeds: Some embed types converted to links

Formatting

• Text formatting: Bold, italic, strikethrough, underline, code
• Colors: Text and background colors where supported
• Links: Internal and external links
• Equations: Mathematical equations using LaTeX

Notion Limitations

• Database content: Notion databases are not fully supported
• Complex embeds: Some embed types may be converted to links
• Advanced blocks: Some specialized Notion blocks may be simplified
• Nested pages: Child pages are not automatically imported

Google Docs Import

Prerequisites

Before importing from Google Docs:

• Ensure you have a Google account with access to Google Docs
• Make sure the documents you want to import are accessible to your account
• Consider organizing your documents in Google Drive for easier selection

How to Import from Google Docs

Step 1: Connect to Google Docs

1. Click "Import from Google Docs" in the import menu
2. Authenticate with Google by clicking "Connect to Google Docs"
3. Grant permissions for CrossPostr to access your Google Docs
4. Wait for authentication to complete

Step 2: Browse and Select Documents

1. Browse all documents in the "All Documents" tab
2. View recent documents in the "Recent" tab for quick access
3. Use the search function to find specific documents by name
4. Click on a document to select it (selected documents show a checkmark)
5. Preview document details including modification date

Step 3: Import Your Content

1. Click "Import Selected Document" once you've made your selection
2. Monitor the import progress with the progress bar
3. Wait for processing - images and formatting are processed automatically
4. Review the imported content in the editor

Google Docs Features Supported

Formatting

• Text formatting: Bold, italic, underline, strikethrough
• Headings: H1 through H6 with proper hierarchy
• Lists: Bulleted and numbered lists with nesting
• Links: External and internal links are preserved
• Text styles: Font colors and highlighting

Structure Elements

• Paragraphs: Regular text paragraphs with spacing
• Tables: Complete table structure with cells and content
• Images: Embedded images with automatic download and optimization
• Page breaks: Converted to appropriate spacing

Advanced Features

• Nested lists: Multi-level bullet and numbered lists
• Table formatting: Cell content and basic table structure
• Image captions: Alt text and captions where available
• Document metadata: Title and last modified information

Google Docs Limitations

• Complex formatting: Some advanced Google Docs formatting may be simplified
• Comments and suggestions: Comments and suggested edits are not imported
• Drawings: Google Drawings are not supported
• Add-ons content: Content from Google Docs add-ons may not transfer

Import Process Details

Authentication

Both Google Docs and Notion imports use secure OAuth authentication:

• Secure connection: All authentication uses industry-standard OAuth 2.0
• Limited permissions: CrossPostr only requests read access to your content
• Session management: Authentication sessions are managed securely
• Logout option: You can disconnect your accounts at any time

Content Processing

Text and Formatting

1. Structure analysis: Document structure is analyzed and preserved
2. Formatting conversion: Rich text formatting is converted to editor format
3. Link preservation: All links are maintained and validated
4. Style mapping: Platform-specific styles are mapped to CrossPostr equivalents

Image Handling

1. Image detection: All images in the document are identified
2. Download processing: Images are securely downloaded and processed
3. Optimization: Images are optimized for web delivery
4. Format conversion: Images are converted to supported formats
5. Alt text preservation: Image descriptions and alt text are maintained

Progress Tracking

• Real-time progress: Import progress is displayed with detailed status
• Current operation: Shows which part of the document is being processed
• Error handling: Any issues are reported with clear error messages
• Completion notification: Success confirmation when import is complete

Best Practices

Before Importing

Prepare Your Content

• Review your documents to ensure they contain the content you want
• Organize your files in Google Drive or Notion for easier selection
• Check permissions to ensure you have access to all necessary content
• Clean up formatting if needed to ensure the best import results

Choose the Right Source

• Google Docs: Best for text-heavy documents with images and tables
• Notion: Ideal for structured content with blocks and rich formatting
• Consider complexity: Simpler documents generally import more successfully

During Import

Optimize the Process

• Select one document at a time for the most reliable results
• Ensure stable internet connection during the import process
• Don't close the browser tab while import is in progress
• Be patient with large documents as they may take longer to process

After Import

Review and Edit

• Check the imported content for accuracy and completeness
• Verify links are working correctly
• Review image placement and alt text
• Adjust formatting if needed using the editor tools
• Test any embedded content to ensure it works properly

Enhance Your Content

• Add CrossPostr-specific features like custom formatting
• Optimize for publishing to your target platforms
• Update metadata including title, description, and tags
• Review SEO elements to ensure discoverability

Troubleshooting

Common Issues

Authentication Problems

Issue: Unable to connect to Google Docs or Notion Solutions:

• Check your internet connection
• Ensure you're using the correct account credentials
• Clear browser cache and cookies
• Try a different browser
• Check for ad blockers that might interfere

Import Failures

Issue: Import process fails or gets stuck Solutions:

• Refresh the page and try again
• Check document permissions in the source platform
• Try importing a smaller or simpler document first
• Ensure the document isn't currently being edited by others

Formatting Issues

Issue: Imported content doesn't look right Solutions:

• Review the original document for complex formatting
• Use CrossPostr's editor tools to adjust formatting
• Check for unsupported features in the source document
• Consider manual formatting adjustments

Image Problems

Issue: Images don't import correctly Solutions:

• Verify images are properly embedded (not just linked)
• Check image file sizes and formats
• Ensure images have proper permissions
• Try re-importing if images are missing

Getting Help

If you encounter issues not covered here:

1. Check our FAQ section for additional troubleshooting tips
2. Contact support through the dashboard help system
3. Join our community forum for user discussions and tips
4. Report bugs if you discover technical issues

Security and Privacy

Data Protection

• Secure transmission: All data is transmitted using encrypted connections
• Temporary processing: Imported content is processed securely and temporarily
• No permanent storage: Source platform credentials are not permanently stored
• Privacy compliance: Import process complies with privacy regulations

Access Control

• Limited scope: CrossPostr only accesses content you explicitly select
• Read-only access: No modifications are made to your source documents
• Session-based: Authentication sessions expire automatically
• User control: You can revoke access at any time

Feature Roadmap

Coming Soon

• Additional platforms: Support for more content sources
• Bulk import: Import multiple documents at once
• Scheduled imports: Automatic import of updated content
• Advanced filtering: Better search and filtering options
• Custom mapping: Configure how formatting is converted

Planned Enhancements

• Team collaboration: Share import templates and settings
• Import templates: Predefined settings for common import scenarios
• Version tracking: Track changes between imported versions
• Selective import: Choose specific sections or blocks to import

---

Ready to import your existing content? Head to your content editor and click the Import button to get started!

Last updated: June 15, 2025