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

# getcustomasset

> Copia um regular workspace file existente para ExtraContent/<hwid>/ e retorna uma rbxasset:// string para o asset path copiado.

<div className="real-function-page">
  ```lua theme={null}
  getcustomasset(path: string): string
  ```

  ## Aliases

  * `getsynasset`

  ## Argumentos

  <ParamField path={"path"} type={"string"} required>
    Path resolvido dentro do workspace apos separator normalization e workspace-boundary checks. O destino deve existir e ser um regular file; folders, invalid filenames, DOS device names e blocked extensions nao sao aceitos.
  </ParamField>

  ## Retornos

  <ResponseField name={"assetId"} type={"string"}>
    String no formato rbxasset://\<hwid>/\<workspace-relative-path>, usando forward slashes no relative path.
  </ResponseField>

  ## Exemplo

  Copie um workspace file existente para o asset folder e imprima o rbxasset path retornado.

  ```lua theme={null}
  local path = "assets/example.txt"
  writefile(path, "asset bytes")

  local assetId = getcustomasset(path)
  print(assetId)
  print(getsynasset(path))
  ```
</div>