# Relationship Links

{% hint style="info" %}
**Who can use this feature?**

Task Owners, Assignees and Admins can add relationship links between tasks&#x20;
{% endhint %}

Relationship Links in Aphex allow you to establish task dependencies, ensuring tasks are completed in the correct order. Whether you need tasks to start together, finish together, or follow one another, Relationship Links help keep your project on track and aligned.

## Drawing Relationship Links&#x20;

***

You can draw links directly on the Gantt - just click and drag from one bar to another. The link type is set based on where you start and end. It’s quick, visual, and often the easiest way to build out your logic as you go.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FaKIGcte51so4n5noAePw%2FDraw%20Link%20(1).svg?alt=media&#x26;token=99817386-6953-431c-bb39-fd578ad1882c" alt=""><figcaption></figcaption></figure>

#### **How to Draw a Relationship Link:**

* Hover over the Predecessor Task Bar and click the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FjWeQ16d4GdQsPoOI5IrV%2FGroup%201321314322.svg?alt=media&#x26;token=4b5e1a98-854a-4e5f-8c21-bbe4c0363538" alt="" data-size="line">
* Click and drag from the predecessor to the successor <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FjWeQ16d4GdQsPoOI5IrV%2FGroup%201321314322.svg?alt=media&#x26;token=4b5e1a98-854a-4e5f-8c21-bbe4c0363538" alt="" data-size="line">
* Release the mouse to automatically create the relationship.

<details>

<summary>Link Type and Direction</summary>

| Direction                | Visual                                                                                                                                                                                                                                  | Explainer                                              |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| **Start > Start (SS)**   | ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fqc5VNj3AWIjF2QJXvKjT%2FStart%20%3E%20Start.svg?alt=media\&token=0248d72f-170c-4417-9906-2a15ae9e8d42)       | The second task starts when the first task starts.     |
| **Start > Finish (SF)**  | ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FV16p1K6kafAU3XukNE3q%2FGroup%20143724530%20\(2\).svg?alt=media\&token=2f9dd4f6-e26e-4e7a-b64b-77aad29775b0) | The second task finishes when the first task starts.   |
| **Finish > Start (FS)**  | ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FiQqKyE6mycKNuMrp21YF%2FGroup%20143724528.svg?alt=media\&token=f6aff1ae-0804-4eba-b614-5fd1042cb732)         | The second task starts when the first task finishes.   |
| **Finish > Finish (FF)** | ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FhcBtuHlQ1OicIy7Wyipv%2FFinish%20%3E%20Finish.svg?alt=media\&token=2d3f61dd-4d9e-4ff6-93f8-7d6a91a78ff1)     | The second task finishes when the first task finishes. |

</details>

<details>

<summary>Scheduling Behaviour</summary>

* Moving a driving task will reschedule all dependent successors in the chain
* Tasks won’t lose their link logic - rescheduling respects the original structure
* Updates happen in real time as you adjust dates, add delays or drag bars on the Gantt

</details>

## Highlight Linked Tasks on the Gantt

***

Spotlight Mode helps you quickly see how a task connects to the rest of the plan.\
Instead of manually tracing arrows or opening extra panels, you can highlight a task and follow its linked pathway directly on the Gantt, with hints showing where the sequence continues off screen.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUCLSyOIIb0wlWWwclTlO%2FSpotlight%20Mode%20(1).svg?alt=media&#x26;token=d48704e3-3016-4c38-ad72-ef0e19bc123d" alt=""><figcaption></figcaption></figure>

#### Turn on Spotlight Mode

* Select a Task Bar on the Gantt
* Click the Spotlight Button <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FVfsEIMJw8ldwtjmtIbNY%2FSpotlight%20Button.svg?alt=media&#x26;token=34ea78a3-68c4-4a5e-8141-97cfd16e5bf2" alt="" data-size="line"> that appears next to the Task
* The linked pathway will be highlighted immediately

#### Use pathway hints

* Look for the small Pathway Hint <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FX1vpkh7PtjqSxAVVmiFW%2FButton.svg?alt=media&#x26;token=e1d5648c-7e3f-4ac6-90b6-61189cdf0e8f" alt="" data-size="line"> tags at the edges of the screen
* These show how many linked Tasks sit just out of view
* Click a hint to preview the linked Tasks or jump directly to them

#### Exit Spotlight Mode

* Click the `X` in the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FTAt1blyMUe5js5BHtJJn%2FSpotlight%20Mode%20Banner.svg?alt=media&#x26;token=0a8f96df-7800-4dbd-b758-1fe103706b0e" alt="" data-size="line"> banner
* Refreshing the page or logging out will also disable Spotlight Mode

<details>

<summary>Spotlight Mode Behaviour</summary>

**While Spotlight is active**

* Clicking another task switches the spotlight to that pathway
* Up and down arrow keys change the spotlighted task
* You can pan, scroll, and switch Views without disabling Spotlight
* All normal task interactions remain available

**Selection behaviour**

* Spotlight follows the currently selected Task
* Clicking into empty space deselects the Task and clears the Pathway Spotlight

**Printing**

* Spotlight is not included in print outputs
* Printing does not disable Spotlight
* Returning to the Gantt keeps Spotlight active

</details>

## Linking Multiple Tasks

***

Checkboxes let you select multiple Tasks and build logic between them all at once. Set the sequence, adjust the link type & lag, and apply. It’s the fastest way to build out a full section of your plan.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FatDcFJ0pKB4x8rVlzYzW%2FFAB%20-%20Relationship%20links%20(2).svg?alt=media&#x26;token=592ffea6-2c2d-442c-94f2-c86bc55dbc16" alt=""><figcaption></figcaption></figure>

#### **To Link Multiple Tasks:**&#x20;

* Hover over tasks and click ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUmk4xHroFcifJzozWIty%2FGrab%20Select.svg?alt=media\&token=2d16c5b8-ca42-4e97-882e-f4bb8c21a5d8)
* Click the Link icon <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FuixkMe63izoIyywQf2b8%2FLink%20Icon%20Button.svg?alt=media&#x26;token=1eb15a9d-bfce-45ac-a104-d88accc87d6a" alt="" data-size="line"> in the multi-select toolbar
* Choose the link type (`SS`, `SF`, `FS`, `FF`), add any lag if needed and confirm

## Link Search&#x20;

***

If the Task you want to link to isn’t visible, drop your link on the blue search icon. A menu will open so you can quickly search and select the right Task without changing your filters or losing your place.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fh6UvF69JwKzPB6UL2VzI%2FLink%20Modal%20(1).svg?alt=media&#x26;token=29ab4889-8f83-4bf9-afb7-be2c68161d1d" alt=""><figcaption></figcaption></figure>

#### **How to Link Tasks using the Link Modal:**&#x20;

* Hover over the Predecessor Task and click the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FwbdorkNVXrbDxxK0Hdpt%2FLink.svg?alt=media&#x26;token=cfc433de-02ad-4705-a8e0-08c2ba50f7c4" alt="" data-size="line">
* Click and drag to <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FcyAgOQF3QJ2lZ2NG27kU%2FLink%20Modal%20Icon.svg?alt=media&#x26;token=938fbc10-624e-49cc-8c02-a4fbdeced167" alt="" data-size="line">
* The Link Search Modal will appear. Use the search bar or filters to find the task you want to link
* Select the task, choose the link type, and apply the relationship

## Creating Links from a Specific Task

***

When you open a Task, you’ll see a full list of its linked Tasks including Link Type, Lag and Float/Driving. From here, you can make changes or add new relationships; no dragging or switching views required.

#### **Adding a Relationship Link from the Task Panel:**

* Open the Task Panel for the task you want to link.
* Scroll to Related Tasks and click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FZYskgSiOa50xIdFEphJl%2F%2B%20icon%20-%20relationship%20links.svg?alt=media&#x26;token=2dccaaf2-dcd1-4175-b019-420b550f5ad1" alt="" data-size="line">
* The Link Search Menu will appear. Use the search bar or filters to find the task you want to link.
* Select the task, choose the link type, and apply the relationship.

## Add or Remove Lag&#x20;

***

Lag lets you add a space between linked Tasks, helping account for handovers, wait times, or real-world gaps without shifting tasks manually. As you adjust Tasks, Aphex gives you a quick visual cue showing how much lag you’ve just added or removed.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FuyH98vd56swmUvK3j7MV%2FLag%20(3).svg?alt=media&#x26;token=6b3da9e2-f155-4ab3-9f76-28e44a110584" alt=""><figcaption></figcaption></figure>

#### **Add Lag to Relationship Links from the Gantt:**&#x20;

* Use the `Task Bar`, or `Start` and `End` properties to edit the dates of the successor Task
* The Lag Change Indicator <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FF0b2cWhbJsQvAtfZ2sUf%2F%EE%8A%9E.svg?alt=media&#x26;token=23f6d159-5238-45ea-8652-9230e1c10d63" alt="" data-size="original"> appears, showing the number of lag days added or removed

#### **Add Lag to Relationship Links from the Task Panel:**&#x20;

* Open the Task Panel for the Task you want to link.
* Scroll to `Related Tasks` and click into the `Lag` field and enter a value

#### **Add Lag to Relationship Links from the Link Modal:**&#x20;

* On the Gantt, click a Link Line
* In the `Link Modal`, click into the `Lag` field and enter a value
* Select <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F4zoZUj7eV1x72cpw9btH%2FSave%20Link%20Button.svg?alt=media&#x26;token=c158cadb-3cb6-4833-96ad-324e0f044b91" alt="" data-size="line"> to apply the Lag change to the relationship

<details>

<summary>Lag Rules </summary>

* The Predecessor Task Calendar is used to determine lag when added to a relationship link
* When drawing Links on the Gantt, Aphex automatically applies zero-day lag, snapping the successor to come immediately after the predecessor
* Hold `Shift` while drawing the link to keep the existing gap - Aphex will automatically calculate and apply the right lag to preserve the spacing between tasks
* The Lag Change Indicator will be visible on the Gantt for a few seconds after the change is applied

</details>

## **Identifying Driving Tasks**

***

Each relationship between Tasks shows whether it’s Driving or how much Float it has.\
A Driving relationship means the predecessor has zero float - any change to it will move the successor.\
Links with float display how much flexibility exists before the successor is affected.\
\
These values update automatically as Task dates, link type, or lag change, helping you see which parts of the schedule are fixed and which still have room to move.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fls2TRF9sd1dBAf1DReHP%2FFAB%20-%20Relationship%20links%20(1).svg?alt=media&#x26;token=9c5a94fa-cd37-4ec7-af95-ef062e53180f" alt=""><figcaption></figcaption></figure>

#### To reveal Driving Tasks & Float from the Gantt:

* Click any relationship link on the Gantt - single or multiple
* In the `Link Menu` that opens, Driving Tasks are marked with ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FaiQiOdeopVIBNyzt0dnj%2FDriving%20Task%20Tag.svg?alt=media\&token=7a98981c-6368-49d8-866e-d43f5153e95c)
* Links that aren’t driving display their Float Value ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FghG7I89iFt57OdEEBUD2%2FFloat%20Tag.svg?alt=media\&token=ad1f59d1-3001-4de7-900e-cf2d7c611419)

<details>

<summary>How Driving Tasks &#x26; Float are calculated </summary>

* **Float** is the amount of time a predecessor task can move without delaying its successor
* It’s calculated automatically using the **start and finish dates** of both tasks, the **relationship type**, and any **lag** that exists between them
* When **Float = 0**, the predecessor is considered **Driving** - any change to it will immediately shift the successor’s dates
* When **Float > 0**, the predecessor is **non-driving** and has flexibility before it impacts the successor
* Float and Driving values update **dynamically** whenever task dates, relationship types, or lag are changed

**Example**

* Predecessor task finishes on: **1 September**
* Successor task starts on: **6 September**
* Lag: **1 day**
* Assume all days are working days

**Step-by-step:**

* Days between 1 Sep and 6 Sept (inclusive): 5 days
* Float = 5 - 0 - 1 = **4 days**

The predecessor has 4 days of float. It can finish as late as **5 September** without delaying the successor

</details>

## Editing & Breaking Links

***

You can edit or break existing relationship links at any time to update or remove connections between Tasks.

#### **How to edit an existing Link:**

* On the Gantt, click a Link Line
* In the Link Modal that opens, you can either:
  * edit the Link Type (FS, SF, FF, SS)
  * edit the Lag
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F4zoZUj7eV1x72cpw9btH%2FSave%20Link%20Button.svg?alt=media&#x26;token=c158cadb-3cb6-4833-96ad-324e0f044b91" alt="" data-size="line"> to apply edits to the relationship

#### **Breaking Relationship Links:**

* On the Gantt, click a Link Line
* In the Link Modal that opens, click `Remove Link`

## **Understanding Scheduling Behaviour**

***

Understanding scheduling behaviour helps you predict how linked tasks behave when dates change based on whether they're Planned, Promised, or Done. It’s the key to controlling movement, Ripple Status, and Progress Updates in your plan.

{% tabs %}
{% tab title="If the Predecessor is Planned" %}

* **Successor is Planned:**
  * Both tasks reschedule freely.
  * Successor follows any changes to the Predecessor.
* **Successor is Promised or Done:**
  * Successor won’t move.
  * &#x20;Only the Predecessor shifts.
    {% endtab %}

{% tab title="If the Predecessor is Promised" %}

* **Successor is Planned:**
  * Successor moves freely and reschedules based on new Predecessor date.
* **Successor is Promised:**
  * You’ll get a Ripple Status prompt.
  * Optionally apply the delay to the Successor.
* **Successor is Done:**
  * Successor won’t move. Only the Promised Predecessor shifts.
    {% endtab %}

{% tab title="If the Predecessor is Done" %}

* &#x20;The task is locked. You can’t move it.
* Any changes must start from its Successors.
  {% endtab %}
  {% endtabs %}

See also: <a href="how-do-i-promise-tasks" class="button secondary">Task Status</a>
