Properties of Graph Elements

The yEd graph editor provides two ways for presenting the properties of nodes or
edges: the Tabular View and the Property Dialog.

The tabular view is shown in a docked window and located in the lower left area of the main window by
default. The property dialog can be opened for example via the context menu for graph elements or using F6
[Mac OS: Command-I], if there is a non-empty set of graph elements selected. Both kinds of presentation show
consistent information and can be used side by side.

Graphical Properties

The graphical properties that are common to nodes and edges include color and line
type (nodes: line type of border).
Furthermore, all properties that are used for the labels of nodes and edges, respectively.
This includes, e. g., font type and size, font color, etc., but also options for
alignment and positioning.

Enhanced Labels

yEd offers two possibilities to enhance your labels. You can apply some text styles
using a subset of HTML and you can let yEd wrap your labels automatically. However,
you cannot combine these possibilities.

HTML Labels

If label text starts with ‘<html>‘, it is automatically interpreted
as HTML markup, which, for example, allows you to style individual parts of the label
differently. Try the following example.

<html><i>italics</i>, <b>bold</b>, <span style="color:red;">red</span></html>

Presentation of label text that uses HTML markup differs between the tabular view
and the property dialog:
in the tabular view, (part of) the rendered HTML is shown while the property dialog
shows the actual HTML markup.

Wrapping Labels

In order to let yEd wrap the lines of a node label automatically such that they fit into
the bounds of the owning node you can do the following. In this case HTML markup is ignored.

  • Select the node.
  • In the “Label” section in the Properties View use “Internal: Center” for the “Placement”.
  • Select “Cropping” in the “Configuration” field.
  • Select “Fit Node Size” or “Fit Node Width” in the “Size” field.

Icons in Labels

A label can contain an icon together with or instead of the label text. The properties
for the label icon as for example the icon itself or its relative position to the
text can be edited using an extra dialog. This dialog opens if you click on Icon Properties.
For an example have a look at the graph Help >> Example Graphs >> Visual Features >> Multiple_Node_Labels_with_Icons.graphml.

Convert Node to Label

An easy way to create a new label with an icon is to drag a node from the palette
and to drop it onto a target node and then to use the entry “Convert to Label” from
the context menu of the dropped node. Icons as edge labels can be created similarly.
If the node to be converted to a label cannot be assigned to a unique target node or edge
then the action “Convert to Label” is not possible. In this case move the dropped node
until it covers just one target object.

Convert Label to Node

It is also possible to convert a label to a node. Select the label and choose the
action “Convert to Node” from its context menu. The label does not have to be created
using “Convert to Label”.

URL and Description

The yEd graph editor allows you to easily bind a URL and a description to nodes and
A description can be used to store additional text besides the label texts. Typically, it is presented as
tooltip when the mouse hovers above a graph element. Descriptions can be specified using either plain text or HTML
By means of the URL, it is possible to open a file from within yEd using the file’s
predefined standard application for the respective platform.

When exporting the graph to HTML image maps or SVG/compressed SVG file format, both
URL and description can be incorporated.


In order to work properly, absolute URLs should start with a valid protocol prefix, for example
file://‘ or ‘http://‘.
URLs may be relative, too, e. g., another_graph.graphml or
images/image3.png and are interpreted relative to the
storage location of the current graph.

Within yEd, the URL of a selected graph element can be opened using ‘Go to URL’ from
the context menu or the
‘View’ menu.

  • URLs that point to another graph will be opened in yEd itself.
  • URLs that start with a proper protocol prefix, will be opened using the available standard application that is
    predefined for the respective platform.

In exported HTML image maps or SVG files which are viewed in a browser,
nodes and edges that have an URL specified can be clicked.
The browser then executes the action that is predefined for the URL’s protocol.

For SVG files to be viewed, the browser has to support the SVG file

Custom Properties

A custom property can be used to associate arbitrary additional data with graph elements. Its domain of definition,
called scope, is either all nodes, all edges or the graph itself. Furthermore, it has a
name, a type for the associated values, and, optionally, a default
which is used for elements without explicitly set value. Each custom property holds only for one graph,
not for all opened graphs.

Custom properties can be saved to and loaded from GraphML files. Technically, each custom property is mapped to a
GraphML attribute. For the support of other formats like GML or TGF, please see the section
on file formats


Use the menu item Edit >> Manage Custom Properties… to open a dialog which
lets you add, delete and update custom properties for the current graph.

The scope of a property cannot be changed after its creation since all element values would be lost. To change the
name, the type of the values or the default value, click on the corresponding table cell in the appropriate table.
Changing an attribute of a custom property takes effect immediately. You do not have to commit your changes or leave
the dialog.

The name of a custom property has to be unique in its scope, e. g., you can have a property foo for the
nodes and a property foo for the edges, but you cannot have two properties named foo for the nodes,
even if their value types are different. If you change the type of a custom property, the existing values are retained
as close as possible. For example, a number can always be converted into a text. In the reverse direction, textual
representations of numbers are converted to the respective numerical values but other text results in an undefined
value. Please note, that this is not an error though, since undefined values are perfectly fine. If you change the
default value, this affects all elements for which you did not enter a value before.

Editing Values

The values of the custom properties of the current selection are displayed in the “Data” section
of the properties views. They can be edited in the properties views, too.
All changes of the attributes of custom properties and their values
are undoable just as any other change of a graph. To undo a change use the menu item Edit >> Undo.

Mapping Properties

By default, custom properties are not visible in the diagram. However, the
properties mapper lets you map custom properties to visual properties.

Simultaneously Displaying and Changing the Properties of Multiple Graph Elements

If multiple graph elements are selected, then both the tabular view and the property
dialog display only those values of attributes that match for all selected elements.
Instead of the values that do not match a gray area is shown.

Both values that do match and values that do not can be changed simultaneously for
all selected graph elements.

Use a Graph Element as a Sample

The representation of a graph element (i.e., all settings for its properties) can
be used as a sample for newly created graph elements.
To this end, the graph element can be added to a user-defined section
in the Palette tool window by means of the ‘Add to Palette’ menu entry from the
editor’s context menu.

More information on working with the palette is found in ‘Palette’ Tool Window.