Menu
×
   ❮     
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP C C++ C# AWS W3.CSS HOW TO BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS DSA TYPESCRIPT ANGULAR ANGULARJS GIT POSTGRESQL MONGODB ASP AI R GO KOTLIN SWIFT SASS VUE GEN AI SCIPY CYBERSECURITY DATA SCIENCE INTRO TO PROGRAMMING INTRO TO HTML & CSS BASH RUST TOOLS MATH

Python Tutorial

Python HOME Python Intro Python Get Started Python Syntax Python Output Python Comments Python Variables Python Data Types Python Numbers Python Casting Python Strings Python Booleans Python Operators Python Lists Python Tuples Python Sets Python Dictionaries Python If...Else Python Match Python While Loops Python For Loops Python Functions Python Range Python Arrays Python Iterators Python Modules Python Dates Python Math Python JSON Python RegEx Python PIP Python Try...Except Python String Formatting Python None Python User Input Python VirtualEnv

Python Classes

Python OOP Python Classes/Objects Python __init__ Method Python self Parameter Python Class Properties Python Class Methods Python Magic Methods Python Inheritance Python Polymorphism Python Encapsulation Python Inner Classes

File Handling

Python File Handling Python Read Files Python Write/Create Files Python Delete Files

Python Modules

NumPy Tutorial Pandas Tutorial SciPy Tutorial Django Tutorial Playwright Tutorial

Python Turtle

Turtle Intro Turtle Move and Turn Turtle Pen Turtle Position Turtle Colors Turtle Shapes Turtle Fill Turtle Text Turtle Events Turtle Animation Turtle Projects

Python Tkinter

Tkinter Intro Tkinter Label Tkinter Button Tkinter Entry Tkinter Layout Tkinter Events Tkinter Check and Radio Tkinter Messagebox Tkinter Listbox Tkinter Text Tkinter Canvas Tkinter ttk Tkinter Menu Tkinter Timers Tkinter Project Tkinter To-Do List

Python Matplotlib

Matplotlib Intro Matplotlib Get Started Matplotlib Pyplot Matplotlib Plotting Matplotlib Markers Matplotlib Line Matplotlib Labels Matplotlib Grid Matplotlib Subplot Matplotlib Scatter Matplotlib Bars Matplotlib Histograms Matplotlib Pie Charts

Machine Learning

Getting Started Mean Median Mode Standard Deviation Percentile Data Distribution Normal Data Distribution Scatter Plot Linear Regression Polynomial Regression Multiple Regression Scale Train/Test Decision Tree Confusion Matrix Hierarchical Clustering Logistic Regression Grid Search Categorical Data K-means Bootstrap Aggregation Cross Validation AUC - ROC Curve K-nearest neighbors

Python DSA

Python DSA Lists and Arrays Stacks Queues Linked Lists Hash Tables Trees Binary Trees Binary Search Trees AVL Trees Graphs Linear Search Binary Search Bubble Sort Selection Sort Insertion Sort Quick Sort Counting Sort Radix Sort Merge Sort

Python MySQL

MySQL Get Started MySQL Create Database MySQL Create Table MySQL Insert MySQL Select MySQL Where MySQL Order By MySQL Delete MySQL Drop Table MySQL Update MySQL Limit MySQL Join

Python MongoDB

MongoDB Get Started MongoDB Create DB MongoDB Collection MongoDB Insert MongoDB Find MongoDB Query MongoDB Sort MongoDB Delete MongoDB Drop Collection MongoDB Update MongoDB Limit

Python Cert

Python Certificate

Python How To

Remove List Duplicates Reverse a String Add Two Numbers

Python Examples

Python Examples Python Videos Python Compiler Python Exercises Python Quiz Python Challenges Python Practice Problems Python Server Python Syllabus Python Study Plan Python Interview Q&A Python Training

Python Reference

Python Overview Python Built-in Functions Python String Methods Python List Methods Python Dictionary Methods Python Tuple Methods Python Set Methods Python File Methods Python Keywords Python Exceptions Python Glossary

Module Reference

Built-in Modules Random Module Requests Module Statistics Module Math Module cMath Module

Turtle Pen


Share

The Pen

The turtle draws with a pen.

When the pen is down, the turtle draws a line when it moves. When the pen is up, the turtle moves without drawing.

The pen is down when the turtle is created. That is why the turtle has drawn a line every time it moved so far.


Pen Up and Pen Down

Use penup() to lift the pen, and pendown() to put it down again:

Example

Draw two lines with a gap between them:

import turtle

t = turtle.Turtle()
t.forward(50)
t.penup()
t.forward(50)
t.pendown()
t.forward(50)

turtle.done()

Result:

Two short lines with a gap between them

Run Example »

The turtle moves 150 pixels in total, but it only draws while the pen is down.

You will often lift the pen to move the turtle to a new place before you start drawing. You will learn how in the Turtle Position chapter.


Pen Size

Use pensize() to set how thick the lines are, in pixels:

Example

Draw a thick line:

import turtle

t = turtle.Turtle()
t.pensize(5)
t.forward(100)

turtle.done()

Result:

A thick line from the middle of the window to the right

Run Example »

The default pen size is 1.

You can change the pen size at any time. The new size is used for the lines drawn after the change:

Example

Draw a line that gets thicker:

import turtle

t = turtle.Turtle()
t.pensize(1)
t.forward(50)
t.pensize(5)
t.forward(50)
t.pensize(10)
t.forward(50)

turtle.done()

Result:

A line that gets thicker in three steps

Run Example »


Hide the Turtle

Use hideturtle() to hide the turtle, so you only see the drawing:

Example

Hide the turtle when the line is drawn:

import turtle

t = turtle.Turtle()
t.forward(100)
t.hideturtle()

turtle.done()

Result:

A straight line from the middle of the window to the right, with no turtle arrow

Run Example »

Use showturtle() to show the turtle again.

A hidden turtle can still move and draw. You just cannot see it.




Free account

Track your progress

XP earned 0 Day streak 0 Spaces 0 League —

New

Learn in Adventure Mode W3Schools Adventure App

Coding fundamentals as bite-sized lessons and challenges.

×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
sales@w3schools.com

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
help@w3schools.com

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookies and privacy policy.

Copyright 1999-2026 by W3Schools. All Rights Reserved. W3Schools is Powered by W3.CSS.