Framapad, the online collaborative text editor offered by Framasoft, was not designed to natively handle image files. Its engine is based on Etherpad, a tool intended for plain text and real-time synchronization among multiple contributors. Integrating a photo or diagram into a pad therefore requires circumventing this limitation, with methods varying depending on the instance used and the level of control desired over the data.
Risk of pad corruption when inserting images
Before seeking the quickest method, one point deserves attention. Feedback from Framapad users since 2023 indicates a real risk of partial content loss when raw HTML or external scripts are injected directly into the pad.
Recommended read : How to Run Well?
The issue arises from the very functioning of Etherpad: each modification is synchronized character by character among all participants. Injecting a large block of code (an image tag with base64 encoding, for example) can cause a synchronization conflict, especially if multiple people are editing at the same time.
Teachers and trainers have documented an approach of dissociating text and images for several years. The text is written in Framapad, but visuals are stored on a separate hosting service (such as an associative or institutional Nextcloud), then integrated into the pad as links.
See also : How to Effectively Manage File Conversion on Windows
This precaution protects the textual content if the pad instance encounters a problem with the image file. You can consult the Digiterio site for your image insertion needs on Framapad.
External image hosting and public link in Framapad
The most reliable method for displaying an image in a Framapad is to host the file elsewhere, then paste its URL into the pad. The pad then interprets the link and can, depending on the version of Etherpad of the instance, display a preview or simply provide a clickable link.
Choose a compatible image host
The image must be accessible via a direct public URL, meaning a link that points to the file itself (ending in .jpg, .png, or .webp), and not to a web page containing the image. Hosting services that generate a viewing page around the photo do not always work correctly in Etherpad.
Several options exist depending on the context:
- A Framaspace or Nextcloud space, which allows generating a public sharing link to an image file uploaded in your personal or associative space
- A personal data-friendly image hosting service, hosted in France or within the organization’s trusted digital space
- An online repository accessible without authentication, such as a shared folder on a collaborative project
Insert the link into the pad
Once the URL is obtained, simply paste it into the body of the text at the desired location. On most recent Etherpad instances, the pad automatically detects the link and makes it clickable. Participants can then open the image in a new tab.
However, online display (the image visible directly in the text, without clicking) depends on the configuration of the instance. Some instances enable a preview plugin, while others do not. Feedback from the field varies on this point depending on the deployed versions.
Pasting a screenshot directly into the pad
An alternative documented in several recent collaborative pad guides is to copy an image and then paste it with Ctrl+V directly into the pad. This method works on some recent Etherpad instances, as well as on similar tools like CryptPad or Hedgedoc.
The principle: you take a screenshot or copy an image from your browser, then paste it into the pad. The instance then automatically hosts the file, without going through a third-party service.
This approach has concrete limitations:
- It does not work on all Framapad instances, as it depends on a specific server-side plugin
- The size of the image file may slow down the synchronization of the pad for all connected participants
- No guarantee of longevity: if the instance deletes inactive pads, the hosted images disappear with the document
For occasional use (meeting, training workshop), this method is the quickest. For a document intended to last, external hosting remains preferable.
Framapad or another tool for image-rich documents
Framapad excels in real-time collaborative note-taking, writing reports, and brainstorming forms. Its clean interface and the absence of a mandatory account make it an accessible tool for any working group.
As soon as the project requires regularly integrating photos, diagrams, or annotated screenshots, other services in the Framasoft ecosystem or free digital tools offer a better experience. A Framaspace that includes an online word processor (based on OnlyOffice or Collabora) natively manages the insertion of images into the body of the document.
The choice of tool depends on the actual need. A collaborative pad with two or three occasional images works very well with the external link method. An illustrated practical guide with many screenshots will be easier to produce on a dedicated documentation platform.
Framapad remains a reliable service for collaborative text. Its limitations regarding images are not a flaw, but a logical consequence of its minimalist design, intended for lightness and user data protection.