---
name: "BIS_fnc_attachToRelative"
type: function
status: ok
groups: ["Object Manipulation"]
arma3_since: "1.64"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_attachToRelative
revid: 378576
updated: 2026-05-10T12:49:53Z
---

# BIS_fnc_attachToRelative

*Function · Object Manipulation · Arma 3 v1.64*

Locality: arguments **local** · effect **global**

## Description

Attaches an object to another, preserving their relative position and orientation.

## Syntax

```sqf
[attachedObject, destinationObject, visual] call BIS_fnc_attachToRelative
```

**Parameters:**

- `attachedObject`: [Object](../topics/Object.md)
- `destinationObject`: [Object](../topics/Object.md)
- `visual`: [Boolean](../topics/Boolean.md) (Optional, default [true](../commands/true.md)) if [true](../commands/true.md) render scope is used else simulation scope. See Simulation vs Render Time Scope for more information

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
[player, car] call BIS_fnc_attachToRelative;
```

## See also

[BIS_fnc_weaponDirectionRelative](../functions/BIS_fnc_weaponDirectionRelative.md) · [BIS_fnc_vectorDirAndUpRelative](../functions/BIS_fnc_vectorDirAndUpRelative.md) · [attachTo](../commands/attachTo.md)

<sub>Source: [BI Community Wiki — BIS fnc attachToRelative](https://community.bistudio.com/wiki/BIS_fnc_attachToRelative) (revision 378576).</sub>