Discover how to display external files within Sage CRM
Our in-house CRM team has built a lightweight integration which enables you to list and securely download files inside Sage CRM that are stored outside your Sage CRM documents, while still preserving the familiar styling and navigation.
In this week’s tip, we explore how to display external files inside Sage CRM, share practical examples, and highlight the key benefits to your business.
Key deliverables
This helpful feature allows you to display folder contents inside your Sage CRM application and delivers reliable downloads by passing a safe token to a dedicated download endpoint.
- Seamless UI integration: File listing rendered via ‘CRM.AddContent’ so output inherits Sage CRM layout and styles.
- Robust file enumeration: Server-side folder enumeration with extension exclusion and safe date/size formatting.
- Reliable download flow: Filenames are encoded as Base64 tokens preventing CRM URL issues.
- Security and validation: Download endpoint validates tokens.
- Entity folder mapping: Listing and download logic map CRM identifiers to subfolders so files are resolved from the correct directory.
- Operational stability: App pool identity and local path usage avoid UNC authentication pitfalls and ensure consistent access.
| Use Case | Why it helps |
| Surface attachments stored on file shares outside of Sage CRM. | Lets users access large or legacy attachments without needing to import into Sage CRM. |
| Archive access for compliance. | Provides read-only access to archived records outside of Sage CRM dashboards. |
| Integrate third-party document stores. | Show documents from network drives or mounted repositories. |
Key benefits
- User experience: Files appear inside the Sage CRM interface with consistent styling and navigation.
- Compatibility: Base64 token approach avoids ‘CRM.URL’ side effects and works across Sage CRM navigation contexts.
- Security: Validation and tokenisation reduce risk of path traversal and header injection.
- Flexibility: Supports files stored outside Sage CRM Documents without changing existing document models.
- Maintainability: Minimal, self-contained Classic ASP changes that are easy to audit and extend.
- Performance: Local path access and optional paging reduce latency and server load.
This approach gives you a polished, secure way to view and retrieve files that live outside the standard ‘Documents’ area, while keeping the implementation simple and maintainable.
If you’d like to explore how external files could be displayed seamlessly inside your Sage CRM system, our CRM team would be happy to help. Just get in touch.
Reviewed by Peter Clarke, Sage CRM Team Leader at PKF Smith Cooper Systems
Last reviewed: May 2026
