Tkinter asksaveasfile() and asksaveasfilename(): Save Files

Tkinter's filedialog module provides native Save As dialogs. Use asksaveasfile() when you want Tkinter to return an opened file object, or asksaveasfilename() when you want the selected file path and prefer to open the file yourself.

Import tkinter.filedialog 🔝

Import the filedialog module from Tkinter:

import tkinter as tk
from tkinter import filedialog

You can then call:

filedialog.asksaveasfile()
filedialog.asksaveasfilename()

There is no need to import asksaveasfile separately if it is being called through filedialog.

Save with asksaveasfile() 🔝

asksaveasfile() displays the Save As dialog and returns an already-opened file object. Its default mode is 'w'.

import tkinter as tk
from tkinter import filedialog

def save_file():
    file_obj=filedialog.asksaveasfile(mode='w', defaultextension='.txt', filetypes=[('Text files', '*.txt')], parent=root)

    if file_obj:
        with file_obj:
            file_obj.write('Welcome to plus2net')

root=tk.Tk()
root.geometry('400x200')
root.title('Save File')

tk.Button(root, text='Save File', command=save_file).pack(pady=50)

root.mainloop()

The returned object is ready for writing:

file_obj.write('Welcome to plus2net')

Using the file object as a context manager ensures that it is closed after writing.

Save with asksaveasfilename() 🔝

asksaveasfilename() returns the selected path instead of opening the file.

import tkinter as tk
from tkinter import filedialog

def save_file():
    file_path=filedialog.asksaveasfilename(defaultextension='.txt', filetypes=[('Text files', '*.txt')], parent=root)

    if file_path:
        with open(file_path, 'w', encoding='utf-8') as file:
            file.write('Welcome to plus2net')

root=tk.Tk()
root.geometry('400x200')

tk.Button(root, text='Save', command=save_file).pack(pady=50)

root.mainloop()

This version gives the program explicit control over how the file is opened, including its encoding.

asksaveasfile() vs asksaveasfilename() 🔝

Handle Cancel Correctly 🔝

The user can close the dialog without selecting a file. Always test the returned value before writing.

asksaveasfilename()

file_path=filedialog.asksaveasfilename()

if file_path:
    print('Selected:', file_path)
else:
    print('Save cancelled.')

asksaveasfile()

file_obj=filedialog.asksaveasfile()

if file_obj:
    with file_obj:
        file_obj.write('Data')
else:
    print('Save cancelled.')

Filter Choices with filetypes 🔝

The filetypes option provides file-type choices in the Save As dialog.

filetypes=[
    ('Text files', '*.txt'),
    ('CSV files', '*.csv'),
    ('All files', '*.*')
]

Use it with:

file_path=filedialog.asksaveasfilename(filetypes=filetypes)

The second value is a file pattern. For example, use:

'*.txt'

rather than:

'.txt'

filetypes affects the file choices shown by the dialog. It does not validate the actual contents of the file.

Add a Default Extension with defaultextension 🔝

defaultextension specifies the extension to use when the user does not enter one.

file_path=filedialog.asksaveasfilename(
    defaultextension='.txt',
    filetypes=[('Text files', '*.txt')]
)

For a CSV file:

file_path=filedialog.asksaveasfilename(
    defaultextension='.csv',
    filetypes=[('CSV files', '*.csv')]
)

Suggest a Filename with initialfile 🔝

initialfile supplies a suggested filename.

file_path=filedialog.asksaveasfilename(
    defaultextension='.txt',
    initialfile='notes.txt',
    filetypes=[('Text files', '*.txt')]
)

The user can keep or change the suggested name.

Choose the Initial Directory 🔝

initialdir sets the directory shown when the Save As dialog first opens.

Using the User's Home Directory

from pathlib import Path

file_path=filedialog.asksaveasfilename(
    initialdir=str(Path.home()),
    defaultextension='.txt'
)

This is more portable than hard-coding a Windows drive such as D:\ or F:\.

Windows Directory

If a Windows path is required, a raw string is convenient:

initialdir=r'D:\my_data\my_html'

Set the Save Dialog Title 🔝

file_path=filedialog.asksaveasfilename(
    title='Save Report',
    defaultextension='.txt'
)

The exact appearance and placement of the title depends on the platform's native file dialog.

Connect the Dialog to its Parent Window 🔝

Use parent=root to associate the Save dialog with the Tkinter window that opened it.

file_path=filedialog.asksaveasfilename(
    parent=root,
    title='Save File'
)

This improves window ownership and modal behaviour, particularly when an application contains several windows.

Confirm Before Overwriting an Existing File 🔝

The native Save As dialog normally asks the user for confirmation when an existing file would be overwritten.

Tk also provides the confirmoverwrite option:

file_path=filedialog.asksaveasfilename(
    defaultextension='.txt',
    confirmoverwrite=True
)

The default behaviour is to request overwrite confirmation.

Save Content from a Tkinter Text Widget 🔝

The following example saves everything entered in a Tkinter text-entry example.

import tkinter as tk
from tkinter import filedialog

def save_text():
    file_path=filedialog.asksaveasfilename(
        parent=root,
        title='Save Text',
        defaultextension='.txt',
        filetypes=[('Text files', '*.txt'), ('All files', '*.*')]
    )

    if not file_path:
        return

    text=text_box.get('1.0', 'end-1c')

    with open(file_path, 'w', encoding='utf-8') as file:
        file.write(text)

    status.config(text='File saved.')

root=tk.Tk()
root.geometry('500x350')
root.title('Save Text File')

text_box=tk.Text(root, width=50, height=12)
text_box.pack(padx=10, pady=10)

tk.Button(root, text='Save As', command=save_text).pack(pady=5)

status=tk.Label(root, text='')
status.pack(pady=5)

root.mainloop()

'end-1c' excludes the automatic final newline maintained by the Tkinter Text widget.

Save Text with UTF-8 Encoding 🔝

When saving text through a returned path, specify an encoding explicitly:

with open(file_path, 'w', encoding='utf-8') as file:
    file.write(text)

This makes the file encoding explicit and supports Unicode text consistently.

Handle File-Saving Errors 🔝

A valid-looking path does not guarantee that writing will succeed. Permissions, unavailable drives or other file-system problems can raise OSError.

try:
    with open(file_path, 'w', encoding='utf-8') as file:
        file.write(text)
except OSError as error:
    print('Unable to save file:', error)

Complete Version with Status Message

def save_text():
    file_path=filedialog.asksaveasfilename(
        parent=root,
        title='Save Text',
        defaultextension='.txt',
        filetypes=[('Text files', '*.txt')]
    )

    if not file_path:
        status.config(text='Save cancelled.')
        return

    text=text_box.get('1.0', 'end-1c')

    try:
        with open(file_path, 'w', encoding='utf-8') as file:
            file.write(text)
        status.config(text='File saved successfully.')
    except OSError as error:
        status.config(text=f'Unable to save: {error}')

Common Tkinter Save Dialog Mistakes 🔝

1. Confusing asksaveasfile() with asksaveasfilename()

This returns a file object:

file_obj=filedialog.asksaveasfile()

This returns a path:

file_path=filedialog.asksaveasfilename()

2. Opening the Result of asksaveasfile() Again

This is unnecessary:

file_obj=filedialog.asksaveasfile()
# open(file_obj, 'w')  # incorrect idea

file_obj is already an opened file object.

3. Writing before Checking Cancel

Always check the result:

if not file_path:
    return

4. Using .txt Instead of *.txt as a File Pattern

Prefer:

('Text files', '*.txt')

5. Hard-Coding a Directory That May Not Exist

Instead of assuming a drive such as F:\data, use a directory that exists or derive one dynamically.

6. Forgetting defaultextension

Use:

defaultextension='.txt'

when the application expects saved files to use a standard extension.

7. Forgetting to Close a File Object

Use a context manager:

with file_obj:
    file_obj.write('Data')

or, when opening a returned path:

with open(file_path, 'w', encoding='utf-8') as file:
    file.write('Data')

8. Disabling Overwrite Confirmation without a Reason

The normal confirmation protects users from accidentally replacing an existing file. Keep it enabled unless the application has another safe overwrite workflow.

9. Treating filetypes as File Validation

The selected filter helps users choose filenames and extensions, but your application must still validate data or file requirements when necessary.

Summary of Tkinter asksaveasfile() 🔝

• tkinter.filedialog provides native Save As dialogs.
• asksaveasfile() returns an opened file object.
• The default mode of asksaveasfile() is 'w'.
• asksaveasfilename() returns the selected file path.
• Test the return value before writing because the user may cancel.
• Use filetypes with patterns such as *.txt and *.csv.
• Use defaultextension to provide a default extension.
• Use initialfile to suggest a filename.
• Use initialdir to select the directory initially displayed.
• Use title to provide a meaningful dialog title.
• Use parent=root to associate the dialog with its Tkinter window.
• The Save dialog normally confirms before overwriting an existing file.
• confirmoverwrite controls the overwrite-confirmation request, although native behaviour can vary by platform.
• Use asksaveasfilename() followed by open() when explicit encoding and file-opening control are required.
• Use encoding='utf-8' when writing general Unicode text files.
• Use a context manager so opened files are closed correctly.
• Catch OSError when the application needs to handle file-system write failures.

Subhendu Mohapatra

Author & Instructor at plus2net

I write and maintain practical tutorials on Python, PHP, SQL, JavaScript, HTML, jQuery, and web development at plus2net. The tutorials focus on clear explanations, working examples, and code that readers can test and adapt while learning.

About the author   Watch on YouTube

Connect: