> For the complete documentation index, see [llms.txt](https://help.sdocs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sdocs.com/s-sign/automation-and-envelope-lifecycle/automate-e-signature-with-flow-builder/launch-sign-in-person-from-a-screen-flow.md).

# Launch Sign in Person from a Screen Flow

<figure><img src="/files/btnaov6rdLcrYVPEs7gr" alt="" width="250"><figcaption></figcaption></figure>

Use this guide when you want a **Screen Flow** to launch an in-person signing session.

Use this pattern when the signer is present on the same device.

The flow follows this order:

1. **Collect Data** that will be used for document generation (S-Sign Enabled Template + Object Record)
2. **Generate the document** from the collected data
3. **Prepare the Envelope** the generated document will be stored in
4. **Seal the Envelope** in preparation to deliver the request
5. **Display** the signing link to the active signer

This pattern is close to a standard email-based S-Sign flow.

The main difference is the final step.

Instead of sending an email first, the flow shows the live signing link.

#### Start here if you are newer to Flow

New to Flow? Start with [Getting Started: Automate Document Generation](/quick-start/document-generation/getting-started-automate-document-generation.md).

If you need the base action pattern, use [Automate E-Signature with Flow Builder](/s-sign/automation-and-envelope-lifecycle/automate-e-signature-with-flow-builder.md).

### Prerequisites

* Access to **Flow Builder**
* An **S-Sign Enabled** template
* A **Screen Flow**
* A generated document step before **Prepare Envelope**
* A screen step placed after **Seal Envelope**

{% hint style="info" %}
**Admin Tip:** If this flow runs from a record page, create a **Text** variable named `recordId`. This name is case-sensitive. Then enable **Available for input**.
{% endhint %}

### Step-by-step tutorial

#### Step 1: Enable Sign in Person on Prepare Envelope

<figure><img src="/files/FdIyZERkH97TuacuTmbc" alt="" width="318"><figcaption></figcaption></figure>

Add **Prepare Envelope** after your document generation step.

Map the generated document into the envelope input.

Set **Sign In Person** to `True`.

This tells S-Sign to create an in-person session.

{% hint style="info" %}
**Admin Note:** The screen link does not come from **Prepare Envelope**. It comes from **Seal Envelope**.
{% endhint %}

#### Step 2: Seal the envelope

<figure><img src="/files/vz98UKWNoZXNAiQCkdwy" alt="" width="249"><figcaption></figcaption></figure>

Add **Seal Envelope** after **Prepare Envelope**.

Map **Envelope Id** from the **Prepare Envelope** output.

This step activates the envelope and creates the live signing session.

The signing link becomes available only after this step runs.

{% hint style="info" %}
**Admin Note:** The `signingLink` output is generated by **Seal Envelope**. You will use that output in the next step.
{% endhint %}

#### Step 3: Add a screen after Seal Envelope

<figure><img src="/files/soaplPFh0Sj5NhgSKKb0" alt="" width="563"><figcaption></figcaption></figure>

Add a **Screen** element after **Seal Envelope**.

Use this screen to present the signer with the live session link.

Do not place the screen before **Seal Envelope**.

If you do, the link will be blank.

#### Step 4: Add the live signing link to Display Text

<figure><img src="/files/BybyypupnoYAX4RsRI0I" alt="" width="375"><figcaption></figcaption></figure>

Inside the screen, add a **Display Text** component.

Add your message and insert a link.

Set **Link URL** to:

```plaintext
{!Seal_Envelope.signingLink}
```

Use the **Seal Envelope** action API name that exists in your flow.

If you renamed the action, use that API name instead.

### Troubleshooting and common errors

<details>

<summary><strong>The signing link is blank</strong></summary>

* **Symptom:** The screen loads, but the link has no value.
* **Cause:** The screen runs before **Seal Envelope**, or the wrong output is mapped.
* **Fix:** Move the screen after **Seal Envelope**. Use `signingLink` from that action.

</details>

<details>

<summary><strong>The signer gets an email instead of signing on the device</strong></summary>

* **Symptom:** The request starts as a standard email flow.
* **Cause:** **Sign In Person** is not set to `True`, or the flow still sends the email immediately.
* **Fix:** Set **Sign In Person** to `True`. Remove or delay the initial email action.

</details>

<details>

<summary><strong>The flow faults during envelope setup</strong></summary>

* **Symptom:** The flow stops on **Prepare Envelope** or **Seal Envelope**.
* **Cause:** A required ID is missing.
* **Fix:** Confirm the generated document feeds **Prepare Envelope**. Confirm **Envelope Id** feeds **Seal Envelope**. Add a **Fault** path to each action.

</details>

### Advanced configurations and reference

* Field-level action details: [Flow Reference (Prepare Envelope)](/developer-hub/document-workflows/flow-reference.md#prepare-envelope)
* Field-level action details: [Flow Reference (Seal Envelope)](/developer-hub/document-workflows/flow-reference.md#seal-envelope)
* **Prepare Envelope** must receive the generated document from your earlier step.
* **Sign In Person** must be `True`.
* **Seal Envelope** returns the `signingLink` output.
* Use `Seal_Envelope.signingLink` only if **Seal Envelope** uses that API name.
* Add **Fault** paths from **Prepare Envelope** and **Seal Envelope** to an error screen.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.sdocs.com/s-sign/automation-and-envelope-lifecycle/automate-e-signature-with-flow-builder/launch-sign-in-person-from-a-screen-flow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
