> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iinkedsign.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Package options

> Learn how to configure signing package options to enhance your integration.

## Overview

When creating a signing package, you can configure various package options to tailor the signing experience to your needs. These options include settings for reminders, expiration, authentication, and more.

See the [Package options reference](/v4/reference/package-options/package-options) for more information.

## Defaults

You can manage the default package options for your entire organization under `Settings` > `Signing Defaults`. These defaults will apply to all packages unless overridden at the package level through package options.

## Geolocation

When creating a signing package, you can enable geolocation tracking to capture the signer's location during the signing process.

<Expandable title="options">
  <ParamField body="requestGeoLocation" type="boolean">
    Request Signers Geolocation while signing documents, joining VSR meetings, performing IDV, and connecting to a mobile signature pad.
  </ParamField>

  <ParamField body="geoLocationOptions" type="object">
    Customize how Geolocation is collected.
    <Badge icon="sparkles" size="sm" color="purple">3.6</Badge>

    <Expandable title="properties">
      <ParamField body="required" type="boolean">
        Require geolocation to be shared before allowing the signer to continue.
      </ParamField>

      <ParamField body="requiredSign" type="boolean">
        Require geolocation to be shared before the signer can sign documents.
        (`required` must also be set to `true`)
      </ParamField>

      <ParamField body="requiredSignaturePad" type="boolean">
        Require geolocation to be shared before the signer can use signature pad.
        (`required` must also be set to `true`)
      </ParamField>

      <ParamField body="requiredMeeting" type="boolean">
        Require geolocation to be shared before the signer can join VSR meetings.
        (`required` must also be set to `true`)
      </ParamField>

      <ParamField body="requiredVerification" type="boolean">
        Require geolocation to be shared before the signer can verify their identity.
        (`required` must also be set to `true`)
      </ParamField>
    </Expandable>
  </ParamField>
</Expandable>

## Multi-Factor Authentication (MFA)

You can enhance the security of your signing packages by enabling Multi-Factor Authentication (MFA) for signers. This adds an extra layer of verification during the signing process.

<Expandable title="options">
  <ParamField body="securityCode" type="boolean">
    Enabled 2FA security code.

    <Tip>
      All signers will require a valid mobile phone number to enable mobile MFA.
    </Tip>
  </ParamField>

  <ParamField body="securityPassphrase" type="boolean">
    Enabled 2FA security passphrase.

    <Tip>
      You must also set a passphrase as part of add or update request to enabled 2FA security passphrase.

      ```json theme={null}
      {
          "options": {
              "securityPassphrase": true,
              ...
          },
          "securityPassphrase": "mySecretPassphrase"
      }
      ```
    </Tip>
  </ParamField>
</Expandable>

## Signatures

You can customize signature options to control how signers sign the documents.

<Expandable title="options">
  <ParamField body="styleInkColor" type="string">
    Override the default ink color `#0000FF` for Ink to Sign signatures and initials with a valid #-hexadecimal RGB color value.
    <Badge icon="sparkles" size="sm" color="purple">2.10</Badge>
  </ParamField>

  <ParamField body="defaultMark" type="string">
    Set preferred default mark type.
    <Badge icon="sparkles" size="sm" color="purple">4.0</Badge>

    <Expandable title="values" defaultOpen>
      <PackagesDefaultMark />
    </Expandable>
  </ParamField>

  <ParamField body="markAll" type="boolean">
    Enable all mark types.
  </ParamField>

  <ParamField body="markClickToSign" type="boolean">
    Enabled click to sign `Accept It`.
  </ParamField>

  <ParamField body="markTypeToSign" type="boolean">
    Enabled type to sign `Type It`.
  </ParamField>

  <ParamField body="markTouchToSign" type="boolean">
    Enabled touch to sign `Ink It`.
  </ParamField>

  <ParamField body="allowMarkTouchToSignMouse" type="boolean">
    Allows signer to use desktop mouse to draw signature via touch to sign.
  </ParamField>
</Expandable>

## Video Signing Room

When creating a Video Signing Room (VSR) package, you can configure specific options to enhance the VSR experience.

<Expandable title="options">
  <ParamField body="meetingVideoRecordingAuto" type="boolean">
    Automatically starts video recording after host starts meeting and first attendee joins.
  </ParamField>

  <ParamField body="meetingVideoRecordingDisabled" type="boolean">
    Disables video recording feature preventing host from recording signing session.
  </ParamField>

  <ParamField body="meetingVideoRetentionPeriod" type="string">
    Add a retention period to all package videos to prevent deletion. (ISO 8601 duration)
  </ParamField>

  <ParamField body="masterFileShareMeetings" type="boolean">
    Share meeting details and videos with guest signers via MasterFile.
  </ParamField>

  <ParamField body="notifyMeeting" type="boolean">
    Send email notification to each signer when Video Signing Room meeting is scheduled.
  </ParamField>

  <ParamField body="notifyMeetingIcsAttachment" type="boolean">
    Include ICS compatible meeting invitation with email notification to schedule meeting date and time in recipients' calendar.
  </ParamField>
</Expandable>