# SaveFilePanelInProject

> Displays the "save file" dialog in the Assets folder of the project and returns the selected path name.

## Definition

* **Type:** Method
* **Namespace:** [UnityEditor](/engine/6000.6/script-reference/unityeditor.md)
* **Assembly:** UnityEditor.CoreModule

## SaveFilePanelInProject(string, string, string, string)

Displays the "save file" dialog in the Assets folder of the project and returns the selected path name.

```csharp
public static string SaveFilePanelInProject(string title, string defaultName, string extension, string message)
```

### Parameters

**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The title of the window to display.**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The placeholder text to display in the "Save As" text field. This is the name of file to be saved.**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The file extension to use in the saved file path. For example, enter "png" to save an image in the PNG format.**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The text summary to display in the dialog window.

### Returns

| Type                                                           | Description                                                                                                 |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| [string](https://learn.microsoft.com/dotnet/api/system.string) | A string path to the saved file. If the dialog was canceled or the save failed, it returns an empty string. |

### Remarks

The returned string is always a project-relative path under the `Assets` folder. It starts with `Assets/`, for example: `Assets/MyFolder/MyFile.asset`

The dialog always opens to the root of the `Assets` folder, regardless of where the user has browsed or saved things to earlier in the session.

The value of `defaultName` is only used to prefill the file name field. Passing a full path in `defaultName` does not change the initial folder.

You can include the extension in `defaultName` (e.g., `MyFile.asset`) and it won't be duplicated if you also include it in the `extension` parameter. In general, the extension should be specified at least once, preferably using the `extension` parameter.

Provide the `extension` without the dot, for example `asset` or `png`. Unity normalizes and enforces the extension based on this argument. If the user types a different extension, Unity may append or correct it to match the provided extension.

The `message` string is shown in the dialog UI as helper text or a prompt under the filename field, though presentation can differ between platforms.

Unity generally does not throw exceptions for typical invalid inputs to this dialog such as bad `defaultName`, empty `extension`, or unusual characters. Instead, the dialog still opens, potentially ignoring or sanitizing bad values.

If the user cancels or the operation can't complete, the return value is an empty string. Common cases where this can happen include:

* The user clicks Cancel.
* The chosen path would be invalid or outside `Assets/` and Unity rejects it.
* The extension enforcement conflicts and Unity can't resolve it.

There is no structured error object; you only get an empty string.

Additional Resources: [EditorUtility.SaveFilePanel](/engine/6000.6/script-reference/unityeditor/editorutility/savefilepanel.md) function.

![EditorUtilitySaveFilePanelInProject (SaveFilePanelInProject)](/api/media?file=/engine/6000.6/media/images/EditorUtilitySaveFilePanelInProject.png)

*Save File panel in project.*

### Examples

```csharp
using UnityEngine;
using UnityEditor;
using System.IO;

public class SaveFilePanelInProjectExample : EditorWindow
{
    [MenuItem("Example/Save Texture In Project")]
    static void Apply()
    {
        Texture2D texture = Selection.activeObject as Texture2D;
        if (texture == null)
        {
            EditorUtility.DisplayDialog("Select Texture", "You must select a texture first!", "OK");
            return;
        }

        string path = EditorUtility.SaveFilePanelInProject("Save png", texture.name + "png", "png",
            "Please enter a file name to save the texture to");
        if (path.Length != 0)
        {
            byte[] pngData = texture.EncodeToPNG();
            if (pngData != null)
            {
                File.WriteAllBytes(path, pngData);

                // As we are saving to the asset folder, tell Unity to scan for modified or new assets
                AssetDatabase.Refresh();
            }
        }
    }
}
```

## SaveFilePanelInProject(string, string, string, string, string)

Displays the "save file" dialog in the Assets folder of the project and returns the selected path name.

```csharp
public static string SaveFilePanelInProject(string title, string defaultName, string extension, string message, string path)
```

### Parameters

**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The title of the window to display.**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The placeholder text to display in the "Save As" text field. This is the name of file to be saved.**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The file extension to use in the saved file path. For example, enter "png" to save an image in the PNG format.**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The text summary to display in the dialog window.**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The working directory for this dialog to open in. The default value is "Assets.".

### Returns

| Type                                                           | Description                                                                                                 |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| [string](https://learn.microsoft.com/dotnet/api/system.string) | A string path to the saved file. If the dialog was canceled or the save failed, it returns an empty string. |

### Remarks

The returned string is always a project-relative path under the `Assets` folder. It starts with `Assets/`, for example: `Assets/MyFolder/MyFile.asset`

The dialog always opens to the root of the `Assets` folder, regardless of where the user has browsed or saved things to earlier in the session.

The value of `defaultName` is only used to prefill the file name field. Passing a full path in `defaultName` does not change the initial folder.

You can include the extension in `defaultName` (e.g., `MyFile.asset`) and it won't be duplicated if you also include it in the `extension` parameter. In general, the extension should be specified at least once, preferably using the `extension` parameter.

Provide the `extension` without the dot, for example `asset` or `png`. Unity normalizes and enforces the extension based on this argument. If the user types a different extension, Unity may append or correct it to match the provided extension.

The `message` string is shown in the dialog UI as helper text or a prompt under the filename field, though presentation can differ between platforms.

Unity generally does not throw exceptions for typical invalid inputs to this dialog such as bad `defaultName`, empty `extension`, or unusual characters. Instead, the dialog still opens, potentially ignoring or sanitizing bad values.

If the user cancels or the operation can't complete, the return value is an empty string. Common cases where this can happen include:

* The user clicks Cancel.
* The chosen path would be invalid or outside `Assets/` and Unity rejects it.
* The extension enforcement conflicts and Unity can't resolve it.

There is no structured error object; you only get an empty string.

Additional Resources: [EditorUtility.SaveFilePanel](/engine/6000.6/script-reference/unityeditor/editorutility/savefilepanel.md) function.

![EditorUtilitySaveFilePanelInProject (SaveFilePanelInProject)](/api/media?file=/engine/6000.6/media/images/EditorUtilitySaveFilePanelInProject.png)

*Save File panel in project.*

### Examples

```csharp
using UnityEngine;
using UnityEditor;
using System.IO;

public class SaveFilePanelInProjectExample : EditorWindow
{
    [MenuItem("Example/Save Texture In Project")]
    static void Apply()
    {
        Texture2D texture = Selection.activeObject as Texture2D;
        if (texture == null)
        {
            EditorUtility.DisplayDialog("Select Texture", "You must select a texture first!", "OK");
            return;
        }

        string path = EditorUtility.SaveFilePanelInProject("Save png", texture.name + "png", "png",
            "Please enter a file name to save the texture to");
        if (path.Length != 0)
        {
            byte[] pngData = texture.EncodeToPNG();
            if (pngData != null)
            {
                File.WriteAllBytes(path, pngData);

                // As we are saving to the asset folder, tell Unity to scan for modified or new assets
                AssetDatabase.Refresh();
            }
        }
    }
}
```