UML activity diagram tutorial

Key takeaways

  • An activity diagram is a UML behavior diagram that shows the activities of a system. Other behavior diagrams include use case and state machine diagrams.

  • The basic components of an activity diagram include actions, decision nodes, control flows, start and end nodes, and swimlanes that assign work to responsible actors.

  • Activity diagram symbols cover starting, ending, merging, forking, and signal-handling steps, so you can model complex flows precisely.

  • Teams use activity diagrams to model algorithm logic, business workflows, use case steps, and software architecture elements, like methods and operations.

  • Lucidchart provides UML shape libraries, ready-made templates, and AI generation for building an activity diagram quickly.

Unified Modeling Language (UML) is powerful for visualizing and documenting software systems, but the terminology can feel overwhelming at first. An activity diagram is essentially a flowchart that shows the activities a system performs, and this guide will help you build one.

What is an activity diagram?

An activity diagram is a UML behavior diagram that models the flow of activities within a system, much like a flowchart. Along with the use case diagram, opens in a new tab and state machine diagram, it describes what must happen in the system being modeled.

This is an example of an activity diagram.
This is an example of an activity diagram.

The Unified Modeling Language groups its diagrams into structure, interaction, and behavior diagrams. UML 2.x reformalized activity diagrams with Petri-net-like semantics, giving flows a clearer, more rigorous meaning.

Stakeholders manage many issues at once, so clarity and brevity matter. Activity diagrams help business and development teams understand the same process using a shared set of symbols for starting, ending, merging, and receiving steps.

Benefits of activity diagrams

Consider creating an activity diagram to:

  • Demonstrate the logic of an algorithm.

  • Describe the steps performed in a UML use case.

  • Illustrate a business process or workflow between users and the system.

  • Simplify and improve any process by clarifying complicated use cases.

  • Model software architecture elements, such as methods, functions, and operations

Basic components of an activity diagram

There are several basic components you’ll see in an activity diagram:

  • Action: An action is a step in which users or software perform a task. Actions are represented by rounded rectangles.

  • Decision node: A decision node is a conditional branch shown as a diamond, with a single input and two or more outputs.

  • Control flows: Control flows are the connectors that show the flow between steps in the diagram.

  • Start node: A start node marks the beginning of the activity, shown as a black circle.

  • End node: An end node marks the final step, shown as an outlined black circle.

  • Swimlanes: Swimlanes are partitions that group actions by the actor or role responsible for them, clarifying who does what.

With Lucid’s activity diagram maker, you can easily build polished activity diagrams.

Learn more

Activity diagram symbols

Activity diagram symbols follow standardized UML notation, so any reader can interpret the flow. Common symbols include:

Start symbol: Marks where the activity begins

black circle
This is what a start symbol looks like.

Action symbol: Shows a single action or step in the flow

Activity symbol: Shows multiple actions

Red rectangle with rounded corners
This is what an action and activity symbol looks like.

Connector: Links symbols to show the direction of the flow

blue open-ended arrow
This is what a connector symbol looks like.

Join symbol (synchronization bar): Combines and synchronizes multiple concurrent flows back into one

Black horizontal line with 2 red arrows above the line and 1 red arrow below the line (all pointing downward)
This is what a join symbol looks like.

Fork symbol: Splits a single flow into multiple concurrent flows

Black horizontal line with one red arrow above and 2 red arrows below the line (all arrows are pointing downward)
This is what a fork symbol looks like.

Decision symbol: A branch point that routes the flow based on a condition

Red horizontal diamond
This is what a decision symbol looks like.

Note symbol: Adds explanatory comments to the diagram

Red rectangle with top-right corner folded over
This is what a note symbol looks like.

Send signal symbol: Shows the flow sending a signal to another process

Red horizontal pentagon (pointy end on the right side)
This is what a send signal symbol looks like.

Receive signal symbol: Shows the flow waiting on or receiving a signal

Red flag-like shape
This is what a receive signal symbol looks like.

Flow final symbol: Ends a single flow without ending the entire activity

Red circle with a red X in the middle
This is what a flow final symbol looks like.

End symbol: Ends all flows and completes the activity

Small black circle with a bigger black outline around it
This is what an end symbol looks like.

Condition text: Labels a flow with the condition under which it runs

Brackets around the word "condition"
This is what a condition text symbol looks like.

Activity diagram examples

An activity diagram example maps out a process flow in a way that is easy to follow. Here are two common scenarios.

Activity diagram for a login page

This example shows the process of logging into a website, from entering a username and password to successfully logging in. It uses distinct container shapes for activities, decisions, and notes.

This is an example of how an activity diagram could be useful when visualizing a login process on a website.
This is an example of how an activity diagram could be useful when visualizing a login process on a website.

Activity diagram for a banking system

This example shows how a customer withdraws and deposits money into a bank account. Both transaction paths appear on a single chart to compare the flows side by side.

This is an example of how an activity diagram could be useful to visualize a banking system flow.
This is an example of how an activity diagram could be useful to visualize a banking system flow.

How to make an activity diagram in Lucidchart

You can make an activity diagram in Lucidchart by adding the UML shape libraries, then dragging symbols onto the canvas and connecting them.

Follow these steps:

  1. Open a blank document or start with a template.

  2. Click the Search icon, then select Shapes > Browse all shapes > UML > UML State/Activity > Use selected shapes.

  3. Drag the symbol you want from the toolbox onto the canvas.

  4. Model the process flow by drawing lines between the shapes.

For more details on enabling shapes, see how to add UML shape libraries, opens in a new tab.

If you prefer a faster start, you can generate an activity diagram with Lucid AI, opens in a new tab from a text prompt, then refine it on the canvas.

This video walks through what a UML activity diagram is, how it differs from a flowchart, and when to use one. It covers standardized notation, including action states, forks, and swimlanes, and shows how to build an activity diagram in Lucidchart

Learn how to make your own UML activity diagram in Lucidchart in this tutorial video.

Ready to get started building activity diagrams in Lucidchart?

Create a UML activity diagram with a free Lucidchart account.

Sign up now

Activity diagram templates and examples

Start faster with these ready-made UML templates:

UML class diagram

Pricing:

Free

UML class diagram, Pricing: Free

UML state diagram

Pricing:

Paid Account

UML state diagram, Pricing: Paid Account

UML sequence diagram

Pricing:

Paid Account

UML sequence diagram, Pricing: Paid Account

State machine diagram UML example

Pricing:

Paid Account

State machine diagram UML example, Pricing: Paid Account

UML activity diagram example

Pricing:

Paid Account

UML activity diagram example, Pricing: Paid Account

UML interaction overview diagram

Pricing:

Paid Account

UML interaction overview diagram, Pricing: Paid Account

Additional UML resources

UML diagram maker

Build any type of UML diagram with Lucidchart's shape libraries, AI generation, and real-time collaboration.

UML diagram tutorial

This comprehensive guide to UML covers its history, the 14 UML diagram types, and the steps to create one.

Sequence diagram tutorial

This guide to UML sequence diagrams explains their symbols and examples for modeling how objects interact over time.

Frequently asked questions about activity diagrams

Everything you need to make a UML diagram

In addition to our online UML diagram tool, Lucidchart offers support and training resources to help you branch out to any type of diagram.

Make a diagram