Skip to main content

Adding attachments to services

Added in eventcatalog@2.57.2

If you have any external resources, diagrams, or documentation that you want to link to your service, you can add them using the attachments property.

This will render a new section on your service page with the attachments.

Adding attachments to services​

To add attachments to a service you need to add them to the attachments array in the service's markdown file.

Attachments can be a url (string) or an object with additional properties.

/services/PaymentService/index.mdx
id: PaymentService
name: Payment Service
attachments:
  - url: https://example.com/adr/001
    title: ADR-001 - Use Kafka for asynchronous messaging
    description: Learn more about why we chose Kafka for asynchronous messaging in this architecture decision record.
    type: 'architecture-decisions'
    icon: FileTextIcon
  - url: https://example.com/adr/001
    title: ADR-002 - Database per service
    description: Learn more about why we chose to use a database per service in this architecture decision record.
    icon: FileTextIcon
    type: 'architecture-decisions'
  - url: https://example.com/c4/e-commerce-system-context.png
    title: E-Commerce System Context (C4)
    description: The C4 diagram context of the E-Commerce system
    type: 'diagrams'
    icon: FileBoxIcon

This will render the following in your service page:

Example

Grouping attachments​

You can group attachments by using the type property in your attachments.

Any attachment with the same type will be grouped together in the UI.

Picking your icon​

You can pick your icon from the lucide icons library.

You can find a list of them here.