{"name":"BIS_fnc_setUnitInsignia","operator":null,"title":"BIS fnc setUnitInsignia","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_setUnitInsignia","revid":378918,"updated":"2026-08-14T14:54:01Z","groups":["Object Manipulation"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.24"}],"since":{"game":"arma3","name":"Arma 3","version":"1.24"},"arma3_since":"1.24","branch":null,"locality":{"argument":"global","effect":"global","server_exec":false},"exec":null,"description":"Sets unit insignia (e.g., shoulder insignia on soldiers). See Arma 3: Unit Insignia for more details and a list of official insignias.","syntaxes":[{"syntax":"[target, className] call BIS_fnc_setUnitInsignia","since":null,"effect":null,"exec":null,"params":[{"name":"target","type":"Object","optional":false,"default":null,"description":"unit to which the insignia is going to be attached","types":["Object"],"since":null,"text":"target: Object - unit to which the insignia is going to be attached"},{"name":"class","type":"String","optional":false,"default":null,"description":"CfgUnitInsignia class name to use. Use an empty string to remove the current insignia.","types":["String"],"since":null,"text":"class: String - CfgUnitInsignia class name to use. Use an empty string to remove the current insignia."}],"returns":{"type":"Boolean","types":["Boolean"],"description":"returns true if successful.","text":"Boolean - returns true if successful."}}],"examples":[{"text":"Place insignia:\n\n```sqf\n[player, \"111thID\"] call BIS_fnc_setUnitInsignia;\n```","code":["[player, \"111thID\"] call BIS_fnc_setUnitInsignia;"]},{"text":"Remove insignia:\n\n```sqf\n[player, \"\"] call BIS_fnc_setUnitInsignia;\n```","code":["[player, \"\"] call BIS_fnc_setUnitInsignia;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["BIS_fnc_getUnitInsignia","Arma 3: Unit Insignia"],"notes":[{"user":"Pierre MGI","date":"2016-08-09T05:26:00Z","text":"In Arma 3: Unit Insignia, you can read:\n\n> You can add a new insignia in Config.cpp and Description.ext.\n\nIf it is possible to add a cfgUnitInsignia class in a description.ext, please note that the path of the texture differs for server and client in MP environment.\nConfig.cpp (addon) is more reliable. Description.ext, in this case, should be used for SP mission only.\n\nThis function calls setObjectTextureGlobal, which is a broken command in MP (see feedback tracker) August 2016."},{"user":"Leopard20","date":"2021-06-21T21:51:00Z","text":"To set the insignia after respawn, add this code to initPlayerLocal.sqf\n\n```sqf\nparams [\"_player\"];\n_player addMPEventHandler [\"MPRespawn\", {\n    params [\"_unit\", \"_corpse\"];\n    private _insignia = [_corpse] call BIS_fnc_getUnitInsignia;\n    [_unit, _insignia] spawn {\n        params [\"_unit\", \"_insignia\"];\n        sleep 1;\n        isNil {\n            _unit setVariable [\"BIS_fnc_setUnitInsignia_class\", nil]; // you can also do [_unit, \"\"] call BIS_fnc_setUnitInsignia, but this way is faster (plus no network traffic)\n            [_unit, _insignia] call BIS_fnc_setUnitInsignia;\n        };\n    };\n}];\n```\n\nNotice that the previous insignia has been **cleared** first to make the change happen (possibly a bug as of Arma 3 v2.05)"}],"categories":["Arma 3: Functions","Arma 3: New Functions","Function Group: Object Manipulation","Functions","Functions: Global Effect","Introduced with Arma 3 version 1.24"],"docblock":null,"filled_from_docblock":[]}