InsertService

The AllowInsertFreeModels property toggles whether ''Free Models'' can be inserted into the game, regardless of whether the place owner owns the asset.

Deprecated. Accepts an asset ID that was once used to approve assets for InsertService. Calling it has no effect. Retained only for backward compatibility; do not use it in new work.

Deprecated. Accepts an asset version ID that was once used to approve assets for InsertService. Calling it has no effect. Retained only for backward compatibility; do not use it in new work.

Creates a new MeshPart with specified CollisionFidelity and RenderFidelity. Because MeshPart.MeshId is read only, this is the way to create a MeshPart through scripts without having to clone an existing one. It throws errors if creation fails.

Returns an array of dictionaries, containing information about various Roblox approved sets.

Returns the most recently uploaded models in the specified category.

Retrieves a list of free Decals from the Catalog.

The GetFreeDecalsAsync function retrieves a list of free Decals from the Catalog. The return type for this method is very odd, as it returns a single table wrapped in a table.

The best way to explain it is to show a visual of the array returned:

[1] = {
	CurrentStartIndex = 1, -- This can vary depending on the page you input.
	TotalCount = 21, -- Always 21.
	Results = {
		-- All parameters here are pseudo. They can vary depending on the asset.
		[1] = {
			Name = "Asset Name",
			AssetId = 0000000,
			AssetVersionId = 0000000,
			CreatorName = "Roblox",
		},
		-- [2], [3], and so on... up to [21]
	},
}

An example for iterating over this list has been provided at the bottom of this page.

Additionally, if you want to insert Models instead, you can use the InsertService:GetFreeModelsAsync() function.

Note: The page argument starts at 0. So Page 1 = 0, Page 2 = 1, etc.

Retrieves a list of Free Models from the Catalog.

The GetFreeModelsAsync function retrieves a list of Free Models from the Catalog. The return type for this method is very odd, as it returns a single table wrapped in a table.

The best way to explain it is to show a visual of the array returned:

[1] = {
	CurrentStartIndex = 1, -- This can vary depending on the page you input.
	TotalCount = 21, -- Always 21.
	Results = {
		-- All parameters here are pseudo. They can vary depending on the asset.
		[1] = {
			Name = "Asset Name",
			AssetId = 0000000,
			AssetVersionId = 0000000,
			CreatorName = "Roblox",
    		}
    		-- [2], [3], and so on... up to [21]
    	}
}

An example for iterating over this list has been provided at the bottom of this page.

Additionally, if you would like to insert free Decals, you can use the InsertService:GetFreeDecalsAsync() function.

Returns the latest AssetVersionId of an asset for assets created by the place creator. Can be used in combination with InsertService:LoadAssetVersion() to load the latest version of a model, even if it gets updated while the game is running.

Returns an array of dictionaries, containing information about sets owned by the user. This includes

• Sets the user is subscribed to.
• Sets that the user created.
• A single set containing the models created by the user.
• A single set containing the decals created by the user.

Note:

• All values in the dictionaries are strings, even if they are a number.

This function is a legacy method used to insert an Instance into Workspace.

The LoadAsset function fetches an asset given its ID and returns a Model containing the asset. For example, to load this public Doge Model, which has the asset ID 257489726, you can use:

local InsertService = game:GetService("InsertService")
local Workspace = game:GetService("Workspace")

local assetId = 257489726
local model = InsertService:LoadAsset(assetId)
model.Parent = Workspace

Calls to this function may fail if a server providing a model is having problems. As such, it's generally a good idea to wrap calls to this function in pcall to catch these kinds of errors.

local InsertService = game:GetService("InsertService")
local Workspace = game:GetService("Workspace")

local assetId = 257489726

local success, model = pcall(InsertService.LoadAsset, InsertService, assetId)
if success and model then
	print("Model loaded successfully")
	model.Parent = Workspace
else
	print("Model failed to load!")
end

Security Check#

An asset loaded by this function must meet one of the following:

• The asset must be created or owned by the game creator.
• The asset must be shared by the asset owner.
• The asset must be owned by Roblox.

Additionally, benign asset types such as t-shirts, shirts, pants and avatar accessories are loadable from any game as they are OpenUse.

To load assets which do not meet the above criteria, such as free Models published on the Store, you must use AssetService:LoadAssetAsync() and enable AssetService.AllowInsertFreeAssets.

See also:

• AssetService:GetBundleDetailsAsync(), to find out which assets are associated with a bundle.
• For plugins, see DataModel:GetObjects()

Returns a model inserted into InsertService containing the asset with the given assetVersionId.