Use Images in Remote Models

There are two ways to use images in remote models:

Images on the Team for Capella Server

When a model is exported to the Team for Capella Server, referenced images which are available in the workspace will be exported along with the model. If the referenced images do not exist, a warning appears in the “Error Log” for each missing image:

To use an image on a remote project (i.e.: already exported), proceed as follows:

If the image is not already on the server, it has to be uploaded, to do so:

When the image is uploaded on the server:


When an image is uploaded on the Team for Capella Server, it keeps the same path it has in the workspace. Thus, it is mandatory to upload images from a project (or a folder in this project) in the workspace with the same name as the project on the Team for Capella Server (in the example above, the project name is A400M in the workspace and on the server).

The same recommendation must be followed when a model referencing images is exported to the Team for Capella Server. This model has to use only images available in its containing project.

If this recommendation is not followed, images that do not have the correct path will not be archived by the “Import projects” job of the Scheduler.

Additional Details about the Above Recommendation

Here is an example of a model referencing an image which is not in its project (and thus do not follow the above recommendation):

If the model is exported, Image1.gif will have the path /Images/ImageFolder1/Image1.gif on the Team for Capella Server.

Now if the model is imported in an empty workspace, the result will be the same as the screenshot above (as expected, imported data are the same as exported data).

Problem: the “Import projects” job will archive only the “TestModel” project and thus the image will be lost.

How to Change an Image Already on the Server

To overwrite an image already uploaded on the server:

In your workspace, put the new image with exactly the same path and the same name as the image you want to overwrite. To know this path:

Upload this image (as explained above).

All diagram elements using the replaced image will be automatically updated.

Images on a Shared Directory

It is also possible to store all images in a dedicated Eclipse project shared by all Team for Capella users working on the same model.

To do so:


Common pitfalls:

  • To see images in diagrams, it is mandatory to have the shared project containing images imported in the workspace and open (this remark is also valid when Capella is launched in command line mode, for example to do HTML export…),
  • When exporting an existing project to the Team for Capella Server, the shared project must not be imported in the workspace or open otherwise all images are going to be exported to the server (and with an incorrect path).