- 6 minutes to read

Images

New 7.5.0

Centralize all your visual assets in one place with the Nodinite Image Library. How many articles in your documentation show the same logo, architecture diagram, or system screenshot? And how many places need updating the moment that image changes? The Image Library answers both questions: upload once, reference everywhere, and when the image changes, every article reflects it automatically—no manual find-and-replace.

✅ Upload once, reference everywhere—no more copying the same image to multiple articles
✅ Update the image once—every article and entity referencing it picks up the change automatically
✅ Browse and search all images by name, title, description, and tags
✅ Control image display size at insertion time with built-in size modifiers
✅ Store accessible alt text alongside every image for screen reader compliance
✅ Copy stable name-based references that work identically in Test and Production

Uploading the image Contoso integration overview with a title, alt text, description and the Tag Contoso: Sales, then replacing its file from the card's Action menu with Edit, Choose Replacement File and Replace Now, ending on the same card with the new 1400 × 560 picture, animated walkthrough (7.12)
Animated walkthrough: in Repository > Images, click Upload New Image, click the drop zone and pick a file (the form shows its preview and Detected File Info, and fills the Title and Alt Text from the file name), adjust the Title and Alt Text, add a Description, and a Tag, and click Upload. Then open the card's Action menu, click Edit > Choose Replacement File > Replace Now, and Close. The title and slug stay; the card shows the new picture.

Get started: Add or manage Article — see the Insert Images from the Image Library section.

Understanding the Image Library

The Image Library is a centralized repository for managing raster and vector images used throughout Nodinite documentation. Before the Image Library, images could only be embedded in articles by uploading individually from file or pasting from clipboard—each storing a separate copy with no searchable gallery, no shared metadata, and no cross-article reuse. Non-image documents such as PDFs and schemas live in the File Library instead.

graph TD ImageLibrary[fa:fa-images Image Library] Articles[fa:fa-newspaper Articles] CustomMetadata[fa:fa-tags Custom Metadata] Integrations[fa:fa-puzzle-piece Integrations] Systems[fa:fa-server Systems] roOther["... all other Entities"] RepositoryModel[fa:fa-sitemap Repository Model] ImageLibrary -- Embedded in --> Articles ImageLibrary -- Referenced by --> CustomMetadata Articles -- Part of --> RepositoryModel CustomMetadata -- Enriches --> Integrations CustomMetadata -- Enriches --> Systems CustomMetadata -- Enriches --> roOther

This diagram shows how the Image Library connects to Articles, Custom Metadata, and other Repository Model entities in Nodinite.

Key Components Explained

Component Role Details
Gallery A single, searchable gallery of every uploaded image, filtered by name, title, description, alt text, or tag Key Capabilities
Name-based reference A unique name slug (e.g., logogoeshere) and the {ndi} token, identical in Test and Production; Copy Reference copies it to the clipboard Name-Based Image References
Size modifiers Eight display sizes, from xxs (64 px) to xxl (1024 px), chosen per insertion without changing the original file Size Modifiers
Alt text Stored with each image and applied automatically at every insertion point Key Capabilities
Formats PNG, JPEG, GIF, WebP, and SVG, up to 10 MB Supported Image Formats

Insert Image picker with the image Contoso order-to-cash flow selected, its title, slug, alt text, description, size, an empty Alt Text Override, and Size m (7.12)
The image picker in the Article editor: search or filter by tag on the left; details, Alt Text Override, and Size on the right.

Where Can I Use Images?

Images from the library can be embedded in:

Use Cases

Documentation Screenshots

Upload a single screenshot of your SAP system configuration once. Reference it in the system overview article, the installation guide, and the troubleshooting guide—all pointing to the same image. When the screenshot changes, replace the image in place in the Image Library, and all three articles show the new version.

Store product logos and brand assets centrally. Technical writers, operations staff, and administrators all draw from the same approved image, ensuring consistency across all knowledge base content.

Team- and System-Tagged Image Libraries

Tag images by system (sap, biztalk, azure) or team (integration-team, platform-ops) to create filtered galleries for each area. Team members find only the images relevant to their work without browsing an unfiltered global collection.

Manage images

New 7.12

Open Repository → Images to see every image as a card with its thumbnail, title, name slug, Tags, size, dimensions, and type. Switch between the Grid, Compact, and List views, use the filter box and Filter on Tag, and tick Include archived to also show archived images, marked Archived.
Image Library grid searched on contoso with Include archived ticked, six Contoso image cards, one marked Archived (7.12)
The grid with Include archived ticked: the archived image has a red frame and an Archived badge.

Hover over a card to show the Edit button in its top-right corner.
One image card with the Edit pencil showing in its top-right corner on hover (7.12)
The Edit pencil appears on hover, for users who may change images.

The Action menu

Click Action on a card for everything you can do with one image.
Action menu of a live image with View, Edit, Copy Reference, Show in Mapify, Show in Mermaid, Archive, and Permanently Delete (7.12)
A live image: Archive retires it, Permanently Delete removes it for good.

Action menu of an archived image with View, Copy Reference, Show in Mapify, Show in Mermaid, Restore, and Permanently Delete (7.12)
An archived image: Restore brings it back.

Menu item What it does
View Opens the image in its viewer
Edit Changes the name, title, alt text, description, and Tags, or replaces the file
Copy Reference Copies the {ndi} name reference to the clipboard (see Name-Based Image References)
Show in Mapify / Show in Mermaid Shows the image with its Tags and the Articles whose text references it
Archive / Restore Retires the image, or brings an archived one back
Permanently Delete Removes the image for good, live or archived; it can't be undone

Work with many images at once

Tick the checkbox on each card, then open With Selected. Each item counts the selected images it applies to: Manage Tags opens the Manage Tags dialog for the selection, Archive counts the live ones, Restore the archived ones, and Permanently Delete all of them.
With Selected menu for a live and an archived image with Manage Tags, Archive (1), Restore (1), and Permanently Delete (2) (7.12)
Two images are ticked, one live and one archived.

Every action asks you to confirm first. Archive, Restore, and Permanently Delete need Modify on Articles in your Role; images are user content, so no Administrator Role is needed (see Permissions).

See where an image is used

Show in Mapify draws the image with its Tags and the Articles whose text uses it; click a node to open it. Show in Mermaid shows the same relations as a Mermaid diagram.
Mapify showing the contoso-logo image node linked to the Tags Contoso Finance and Contoso Sales (7.12)
Mapify shows an image and what it relates to; with Articles that reference the image, they appear on the map too.

Mermaid dialog for the image contoso-logo with its two Tags (7.12)
The same relations as a Mermaid diagram.

What You Need Before Starting

  • Access to the Nodinite Web Client; every authenticated user can view and insert images
  • Create on Articles to upload images, and Modify on Articles to edit, archive, restore, or permanently delete them (Permissions)

How do I work with Images?

Navigate to Repository → Images in the Nodinite Web Client to access the Image Library, upload images, edit their metadata, and copy references.

Next Steps