Pluslide LogoPluslide
Call APIBest Practices

Export Options

Choose the right export options for PPTX generation. Compare sync vs async modes, compression levels, and optimization strategies for speed and file size.

Pluslide applies several optimizations by default to ensure the best experience for your end users. However, depending on your specific use case, you may want to adjust these settings to optimize for speed or file size.

Default Behavior

By default, Pluslide performs the following optimizations:

OptionDefaultPurpose
compressImagestrueCompress images to reduce file size and improve download speed
embedFontstrueEmbed fonts to ensure consistent rendering across all devices
formatpptxExport format (pptx, pdf, or google-slides)
asyncfalseProcess export asynchronously and return immediately with task ID
devfalseEnable development mode for testing without consuming quota

Disabling Image Compression

If your images are already optimized or you need faster generation times, you can disable image compression:

{
  "projectId": "your_project_id",
  "presentation": { ... },
  "options": {
    "compressImages": false
  }
}

When to Disable

  • Your images are already compressed or optimized
  • You need the fastest possible generation time

Trade-offs

  • Faster generation: Skipping compression reduces processing time
  • Larger file size: Uncompressed images may result in larger output files

Disabling Font Embedding

Font embedding ensures your presentation looks identical on any device. If you can tolerate minor layout differences, disabling this option significantly reduces file size:

{
  "projectId": "your_project_id",
  "presentation": { ... },
  "options": {
    "embedFonts": false
  }
}

When to Disable

  • You're distributing presentations internally where fonts are installed
  • File size is a critical concern (reduces ~550 KB per presentation)
  • You can accept minor font substitution on devices without the fonts

Trade-offs

  • Smaller file size: Approximately 550 KB reduction
  • Potential layout differences: Text may wrap differently or appear slightly different on devices without the embedded fonts

Export Format

Pluslide supports three export formats:

FormatValueDescription
PowerPointpptxDefault format. Best compatibility with Microsoft PowerPoint and other presentation software.
PDFpdfIdeal for viewing and sharing. Not editable.
Google Slidesgoogle-slidesCreates a Google Slides file in Pluslide's Google Drive.
{
  "projectId": "your_project_id",
  "presentation": { ... },
  "options": {
    "format": "pptx"
  }
}

Google Slides

Important notes:

  • The returned URL is an edit link — anyone with the link can edit the presentation
  • The file is stored in Pluslide's Google Drive and will be automatically deleted based on your plan's retention policy (same as PPTX/PDF)
  • To keep the presentation permanently, copy it to your own Google Drive before the expiration date

Async Mode

When you need to handle large presentations or want to avoid HTTP timeouts, enable async mode:

{
  "projectId": "your_project_id",
  "presentation": { ... },
  "options": {
    "async": true
  }
}

How It Works

  1. Immediate Response: The API returns immediately with a task ID
  2. Background Processing: The export is processed in the background
  3. Status Polling: Use GET /v1/presentation/:id to check the status

When to Use Async Mode

  • Large presentations with many slides or images
  • When you need to avoid HTTP timeout issues
  • When you want to queue multiple exports and process them in parallel
  • When you don't need to provide the download link immediately and want faster response times for your users

Trade-offs

  • No blocking: Your application can continue while the export processes
  • Additional polling: You need to implement status polling logic
  • Eventual consistency: The file may not be available immediately

Development Mode

Enable development mode to test your integration without consuming quota:

{
  "projectId": "your_project_id",
  "presentation": { ... },
  "options": {
    "dev": true
  }
}

For detailed information, see Development Mode.


Only disable these options if you understand the trade-offs. For most production use cases, the defaults provide the best balance of quality and compatibility.

On this page