[{"data":1,"prerenderedAt":2130},["ShallowReactive",2],{"doc-\u002Freference\u002Fpython-list-insert-method":3},{"id":4,"title":5,"body":6,"description":2123,"extension":2124,"meta":2125,"navigation":428,"path":2126,"seo":2127,"stem":2128,"__hash__":2129},"content\u002Freference\u002Fpython-list-insert-method.md","Python List insert() Method",{"type":7,"value":8,"toc":2083},"minimark",[9,19,26,29,45,135,141,149,154,173,179,183,209,228,231,300,303,339,356,360,363,474,476,556,562,566,576,581,587,643,645,670,674,677,730,732,756,760,763,817,819,843,847,853,926,928,969,977,985,988,994,1002,1007,1015,1017,1123,1125,1194,1201,1208,1212,1217,1223,1226,1301,1303,1334,1341,1344,1372,1375,1398,1402,1405,1427,1430,1454,1456,1516,1518,1550,1557,1562,1615,1617,1642,1645,1697,1699,1720,1724,1729,1732,1788,1790,1818,1827,1831,1837,1917,1920,1934,1940,1945,1948,1962,1976,1983,1987,1994,1999,2003,2006,2013,2019,2028,2036,2040,2079],[10,11,13,14,18],"h1",{"id":12},"python-list-insert-method","Python List ",[15,16,17],"code",{},"insert()"," Method",[20,21,22,25],"p",{},[15,23,24],{},"list.insert()"," adds an item to a list at a specific position.",[20,27,28],{},"This method is useful when the position matters. For example, you may want to add a new value at the beginning of a list, in the middle, or just before the last item.",[20,30,31,32,34,35,44],{},"Use ",[15,33,17],{}," when you need to place an item at a chosen index. If you only want to add an item at the end, see the ",[36,37,39,40,43],"a",{"href":38},"\u002Freference\u002Fpython-list-append-method\u002F","Python list ",[15,41,42],{},"append()"," method",".",[46,47,52],"pre",{"className":48,"code":49,"language":50,"meta":51,"style":51},"language-python shiki shiki-themes material-theme-lighter github-light github-dark","numbers = [1, 2, 4]\nnumbers.insert(2, 3)\nprint(numbers)\n# [1, 2, 3, 4]\n","python","",[15,53,54,89,115,128],{"__ignoreMap":51},[55,56,59,63,67,71,75,78,81,83,86],"span",{"class":57,"line":58},"line",1,[55,60,62],{"class":61},"su5hD","numbers ",[55,64,66],{"class":65},"smGrS","=",[55,68,70],{"class":69},"sP7_E"," [",[55,72,74],{"class":73},"srdBf","1",[55,76,77],{"class":69},",",[55,79,80],{"class":73}," 2",[55,82,77],{"class":69},[55,84,85],{"class":73}," 4",[55,87,88],{"class":69},"]\n",[55,90,92,95,97,101,104,107,109,112],{"class":57,"line":91},2,[55,93,94],{"class":61},"numbers",[55,96,44],{"class":69},[55,98,100],{"class":99},"slqww","insert",[55,102,103],{"class":69},"(",[55,105,106],{"class":73},"2",[55,108,77],{"class":69},[55,110,111],{"class":73}," 3",[55,113,114],{"class":69},")\n",[55,116,118,122,124,126],{"class":57,"line":117},3,[55,119,121],{"class":120},"sptTA","print",[55,123,103],{"class":69},[55,125,94],{"class":99},[55,127,114],{"class":69},[55,129,131],{"class":57,"line":130},4,[55,132,134],{"class":133},"sutJx","# [1, 2, 3, 4]\n",[20,136,31,137,140],{},[15,138,139],{},"list.insert(index, value)"," to add an item at a specific position.",[142,143,145,146,148],"h2",{"id":144},"what-listinsert-does","What ",[15,147,24],{}," does",[20,150,151,153],{},[15,152,24],{},":",[155,156,157,161,164,167],"ul",{},[158,159,160],"li",{},"Adds one item into a list at a chosen position",[158,162,163],{},"Shifts existing items to the right",[158,165,166],{},"Changes the original list in place",[158,168,169,170],{},"Returns ",[15,171,172],{},"None",[20,174,175,176,178],{},"That last point is important. ",[15,177,17],{}," does not create a new list.",[142,180,182],{"id":181},"syntax","Syntax",[46,184,186],{"className":48,"code":185,"language":50,"meta":51,"style":51},"my_list.insert(index, item)\n",[15,187,188],{"__ignoreMap":51},[55,189,190,193,195,197,199,202,204,207],{"class":57,"line":58},[55,191,192],{"class":61},"my_list",[55,194,44],{"class":69},[55,196,100],{"class":99},[55,198,103],{"class":69},[55,200,201],{"class":99},"index",[55,203,77],{"class":69},[55,205,206],{"class":99}," item",[55,208,114],{"class":69},[155,210,211,216,222],{},[158,212,213,215],{},[15,214,201],{}," is the position where the new item should go",[158,217,218,221],{},[15,219,220],{},"item"," is the value to add",[158,223,224,225],{},"The first list position is index ",[15,226,227],{},"0",[20,229,230],{},"Example:",[46,232,234],{"className":48,"code":233,"language":50,"meta":51,"style":51},"letters = [\"a\", \"c\"]\nletters.insert(1, \"b\")\nprint(letters)\n",[15,235,236,266,290],{"__ignoreMap":51},[55,237,238,241,243,245,249,252,254,256,259,262,264],{"class":57,"line":58},[55,239,240],{"class":61},"letters ",[55,242,66],{"class":65},[55,244,70],{"class":69},[55,246,248],{"class":247},"sjJ54","\"",[55,250,36],{"class":251},"s_sjI",[55,253,248],{"class":247},[55,255,77],{"class":69},[55,257,258],{"class":247}," \"",[55,260,261],{"class":251},"c",[55,263,248],{"class":247},[55,265,88],{"class":69},[55,267,268,271,273,275,277,279,281,283,286,288],{"class":57,"line":91},[55,269,270],{"class":61},"letters",[55,272,44],{"class":69},[55,274,100],{"class":99},[55,276,103],{"class":69},[55,278,74],{"class":73},[55,280,77],{"class":69},[55,282,258],{"class":247},[55,284,285],{"class":251},"b",[55,287,248],{"class":247},[55,289,114],{"class":69},[55,291,292,294,296,298],{"class":57,"line":117},[55,293,121],{"class":120},[55,295,103],{"class":69},[55,297,270],{"class":99},[55,299,114],{"class":69},[20,301,302],{},"Output:",[46,304,306],{"className":48,"code":305,"language":50,"meta":51,"style":51},"['a', 'b', 'c']\n",[15,307,308],{"__ignoreMap":51},[55,309,310,313,316,318,320,322,325,327,329,331,333,335,337],{"class":57,"line":58},[55,311,312],{"class":69},"[",[55,314,315],{"class":247},"'",[55,317,36],{"class":251},[55,319,315],{"class":247},[55,321,77],{"class":69},[55,323,324],{"class":247}," '",[55,326,285],{"class":251},[55,328,315],{"class":247},[55,330,77],{"class":69},[55,332,324],{"class":247},[55,334,261],{"class":251},[55,336,315],{"class":247},[55,338,88],{"class":69},[20,340,341,342,345,346,348,349,352,353,44],{},"Here, ",[15,343,344],{},"\"b\""," is inserted at index ",[15,347,74],{},", so it appears between ",[15,350,351],{},"\"a\""," and ",[15,354,355],{},"\"c\"",[142,357,359],{"id":358},"basic-example","Basic example",[20,361,362],{},"Here is a simple before-and-after example:",[46,364,366],{"className":48,"code":365,"language":50,"meta":51,"style":51},"colors = [\"red\", \"blue\", \"green\"]\nprint(\"Before:\", colors)\n\ncolors.insert(1, \"yellow\")\nprint(\"After: \", colors)\n",[15,367,368,404,424,430,454],{"__ignoreMap":51},[55,369,370,373,375,377,379,382,384,386,388,391,393,395,397,400,402],{"class":57,"line":58},[55,371,372],{"class":61},"colors ",[55,374,66],{"class":65},[55,376,70],{"class":69},[55,378,248],{"class":247},[55,380,381],{"class":251},"red",[55,383,248],{"class":247},[55,385,77],{"class":69},[55,387,258],{"class":247},[55,389,390],{"class":251},"blue",[55,392,248],{"class":247},[55,394,77],{"class":69},[55,396,258],{"class":247},[55,398,399],{"class":251},"green",[55,401,248],{"class":247},[55,403,88],{"class":69},[55,405,406,408,410,412,415,417,419,422],{"class":57,"line":91},[55,407,121],{"class":120},[55,409,103],{"class":69},[55,411,248],{"class":247},[55,413,414],{"class":251},"Before:",[55,416,248],{"class":247},[55,418,77],{"class":69},[55,420,421],{"class":99}," colors",[55,423,114],{"class":69},[55,425,426],{"class":57,"line":117},[55,427,429],{"emptyLinePlaceholder":428},true,"\n",[55,431,432,435,437,439,441,443,445,447,450,452],{"class":57,"line":130},[55,433,434],{"class":61},"colors",[55,436,44],{"class":69},[55,438,100],{"class":99},[55,440,103],{"class":69},[55,442,74],{"class":73},[55,444,77],{"class":69},[55,446,258],{"class":247},[55,448,449],{"class":251},"yellow",[55,451,248],{"class":247},[55,453,114],{"class":69},[55,455,457,459,461,463,466,468,470,472],{"class":57,"line":456},5,[55,458,121],{"class":120},[55,460,103],{"class":69},[55,462,248],{"class":247},[55,464,465],{"class":251},"After: ",[55,467,248],{"class":247},[55,469,77],{"class":69},[55,471,421],{"class":99},[55,473,114],{"class":69},[20,475,302],{},[46,477,479],{"className":48,"code":478,"language":50,"meta":51,"style":51},"Before: ['red', 'blue', 'green']\nAfter:  ['red', 'yellow', 'blue', 'green']\n",[15,480,481,514],{"__ignoreMap":51},[55,482,483,486,488,490,492,494,496,498,500,502,504,506,508,510,512],{"class":57,"line":58},[55,484,485],{"class":61},"Before",[55,487,153],{"class":69},[55,489,70],{"class":69},[55,491,315],{"class":247},[55,493,381],{"class":251},[55,495,315],{"class":247},[55,497,77],{"class":69},[55,499,324],{"class":247},[55,501,390],{"class":251},[55,503,315],{"class":247},[55,505,77],{"class":69},[55,507,324],{"class":247},[55,509,399],{"class":251},[55,511,315],{"class":247},[55,513,88],{"class":69},[55,515,516,519,521,524,526,528,530,532,534,536,538,540,542,544,546,548,550,552,554],{"class":57,"line":91},[55,517,518],{"class":61},"After",[55,520,153],{"class":69},[55,522,523],{"class":69},"  [",[55,525,315],{"class":247},[55,527,381],{"class":251},[55,529,315],{"class":247},[55,531,77],{"class":69},[55,533,324],{"class":247},[55,535,449],{"class":251},[55,537,315],{"class":247},[55,539,77],{"class":69},[55,541,324],{"class":247},[55,543,390],{"class":251},[55,545,315],{"class":247},[55,547,77],{"class":69},[55,549,324],{"class":247},[55,551,399],{"class":251},[55,553,315],{"class":247},[55,555,88],{"class":69},[20,557,558,559,561],{},"The new value appears at index ",[15,560,74],{},". The existing items from that position onward move one place to the right.",[142,563,565],{"id":564},"how-the-index-works","How the index works",[20,567,568,569,571,572,575],{},"The ",[15,570,201],{}," in ",[15,573,574],{},"insert(index, item)"," controls where the new item is placed.",[577,578,580],"h3",{"id":579},"insert-at-the-beginning","Insert at the beginning",[20,582,583,584,586],{},"Use index ",[15,585,227],{}," to add an item at the start of the list.",[46,588,590],{"className":48,"code":589,"language":50,"meta":51,"style":51},"nums = [2, 3, 4]\nnums.insert(0, 1)\nprint(nums)\n",[15,591,592,613,633],{"__ignoreMap":51},[55,593,594,597,599,601,603,605,607,609,611],{"class":57,"line":58},[55,595,596],{"class":61},"nums ",[55,598,66],{"class":65},[55,600,70],{"class":69},[55,602,106],{"class":73},[55,604,77],{"class":69},[55,606,111],{"class":73},[55,608,77],{"class":69},[55,610,85],{"class":73},[55,612,88],{"class":69},[55,614,615,618,620,622,624,626,628,631],{"class":57,"line":91},[55,616,617],{"class":61},"nums",[55,619,44],{"class":69},[55,621,100],{"class":99},[55,623,103],{"class":69},[55,625,227],{"class":73},[55,627,77],{"class":69},[55,629,630],{"class":73}," 1",[55,632,114],{"class":69},[55,634,635,637,639,641],{"class":57,"line":117},[55,636,121],{"class":120},[55,638,103],{"class":69},[55,640,617],{"class":99},[55,642,114],{"class":69},[20,644,302],{},[46,646,648],{"className":48,"code":647,"language":50,"meta":51,"style":51},"[1, 2, 3, 4]\n",[15,649,650],{"__ignoreMap":51},[55,651,652,654,656,658,660,662,664,666,668],{"class":57,"line":58},[55,653,312],{"class":69},[55,655,74],{"class":73},[55,657,77],{"class":69},[55,659,80],{"class":73},[55,661,77],{"class":69},[55,663,111],{"class":73},[55,665,77],{"class":69},[55,667,85],{"class":73},[55,669,88],{"class":69},[577,671,673],{"id":672},"insert-in-the-middle","Insert in the middle",[20,675,676],{},"A middle index inserts between existing items.",[46,678,680],{"className":48,"code":679,"language":50,"meta":51,"style":51},"nums = [1, 2, 4]\nnums.insert(2, 3)\nprint(nums)\n",[15,681,682,702,720],{"__ignoreMap":51},[55,683,684,686,688,690,692,694,696,698,700],{"class":57,"line":58},[55,685,596],{"class":61},[55,687,66],{"class":65},[55,689,70],{"class":69},[55,691,74],{"class":73},[55,693,77],{"class":69},[55,695,80],{"class":73},[55,697,77],{"class":69},[55,699,85],{"class":73},[55,701,88],{"class":69},[55,703,704,706,708,710,712,714,716,718],{"class":57,"line":91},[55,705,617],{"class":61},[55,707,44],{"class":69},[55,709,100],{"class":99},[55,711,103],{"class":69},[55,713,106],{"class":73},[55,715,77],{"class":69},[55,717,111],{"class":73},[55,719,114],{"class":69},[55,721,722,724,726,728],{"class":57,"line":117},[55,723,121],{"class":120},[55,725,103],{"class":69},[55,727,617],{"class":99},[55,729,114],{"class":69},[20,731,302],{},[46,733,734],{"className":48,"code":647,"language":50,"meta":51,"style":51},[15,735,736],{"__ignoreMap":51},[55,737,738,740,742,744,746,748,750,752,754],{"class":57,"line":58},[55,739,312],{"class":69},[55,741,74],{"class":73},[55,743,77],{"class":69},[55,745,80],{"class":73},[55,747,77],{"class":69},[55,749,111],{"class":73},[55,751,77],{"class":69},[55,753,85],{"class":73},[55,755,88],{"class":69},[577,757,759],{"id":758},"insert-past-the-end","Insert past the end",[20,761,762],{},"If the index is greater than the list length, Python adds the item at the end.",[46,764,766],{"className":48,"code":765,"language":50,"meta":51,"style":51},"nums = [1, 2, 3]\nnums.insert(10, 4)\nprint(nums)\n",[15,767,768,788,807],{"__ignoreMap":51},[55,769,770,772,774,776,778,780,782,784,786],{"class":57,"line":58},[55,771,596],{"class":61},[55,773,66],{"class":65},[55,775,70],{"class":69},[55,777,74],{"class":73},[55,779,77],{"class":69},[55,781,80],{"class":73},[55,783,77],{"class":69},[55,785,111],{"class":73},[55,787,88],{"class":69},[55,789,790,792,794,796,798,801,803,805],{"class":57,"line":91},[55,791,617],{"class":61},[55,793,44],{"class":69},[55,795,100],{"class":99},[55,797,103],{"class":69},[55,799,800],{"class":73},"10",[55,802,77],{"class":69},[55,804,85],{"class":73},[55,806,114],{"class":69},[55,808,809,811,813,815],{"class":57,"line":117},[55,810,121],{"class":120},[55,812,103],{"class":69},[55,814,617],{"class":99},[55,816,114],{"class":69},[20,818,302],{},[46,820,821],{"className":48,"code":647,"language":50,"meta":51,"style":51},[15,822,823],{"__ignoreMap":51},[55,824,825,827,829,831,833,835,837,839,841],{"class":57,"line":58},[55,826,312],{"class":69},[55,828,74],{"class":73},[55,830,77],{"class":69},[55,832,80],{"class":73},[55,834,77],{"class":69},[55,836,111],{"class":73},[55,838,77],{"class":69},[55,840,85],{"class":73},[55,842,88],{"class":69},[577,844,846],{"id":845},"use-a-negative-index","Use a negative index",[20,848,849,850,852],{},"Negative indexes count from the end of the list. ",[15,851,17],{}," places the item before that position.",[46,854,856],{"className":48,"code":855,"language":50,"meta":51,"style":51},"letters = [\"a\", \"b\", \"d\"]\nletters.insert(-1, \"c\")\nprint(letters)\n",[15,857,858,891,916],{"__ignoreMap":51},[55,859,860,862,864,866,868,870,872,874,876,878,880,882,884,887,889],{"class":57,"line":58},[55,861,240],{"class":61},[55,863,66],{"class":65},[55,865,70],{"class":69},[55,867,248],{"class":247},[55,869,36],{"class":251},[55,871,248],{"class":247},[55,873,77],{"class":69},[55,875,258],{"class":247},[55,877,285],{"class":251},[55,879,248],{"class":247},[55,881,77],{"class":69},[55,883,258],{"class":247},[55,885,886],{"class":251},"d",[55,888,248],{"class":247},[55,890,88],{"class":69},[55,892,893,895,897,899,901,904,906,908,910,912,914],{"class":57,"line":91},[55,894,270],{"class":61},[55,896,44],{"class":69},[55,898,100],{"class":99},[55,900,103],{"class":69},[55,902,903],{"class":65},"-",[55,905,74],{"class":73},[55,907,77],{"class":69},[55,909,258],{"class":247},[55,911,261],{"class":251},[55,913,248],{"class":247},[55,915,114],{"class":69},[55,917,918,920,922,924],{"class":57,"line":117},[55,919,121],{"class":120},[55,921,103],{"class":69},[55,923,270],{"class":99},[55,925,114],{"class":69},[20,927,302],{},[46,929,931],{"className":48,"code":930,"language":50,"meta":51,"style":51},"['a', 'b', 'c', 'd']\n",[15,932,933],{"__ignoreMap":51},[55,934,935,937,939,941,943,945,947,949,951,953,955,957,959,961,963,965,967],{"class":57,"line":58},[55,936,312],{"class":69},[55,938,315],{"class":247},[55,940,36],{"class":251},[55,942,315],{"class":247},[55,944,77],{"class":69},[55,946,324],{"class":247},[55,948,285],{"class":251},[55,950,315],{"class":247},[55,952,77],{"class":69},[55,954,324],{"class":247},[55,956,261],{"class":251},[55,958,315],{"class":247},[55,960,77],{"class":69},[55,962,324],{"class":247},[55,964,886],{"class":251},[55,966,315],{"class":247},[55,968,88],{"class":69},[20,970,971,972,976],{},"If you are still getting comfortable with list positions, the ",[36,973,975],{"href":974},"\u002Flearn\u002Fpython-lists-explained-beginner-guide\u002F","Python lists beginner guide"," can help.",[142,978,980,982,983],{"id":979},"insert-vs-append",[15,981,17],{}," vs ",[15,984,42],{},[20,986,987],{},"These methods both add items to a list, but they do different jobs.",[577,989,31,991,993],{"id":990},"use-insert-when",[15,992,17],{}," when:",[155,995,996,999],{},[158,997,998],{},"You want to add an item at a specific position",[158,1000,1001],{},"The order of the list matters",[577,1003,31,1005,993],{"id":1004},"use-append-when",[15,1006,42],{},[155,1008,1009,1012],{},[158,1010,1011],{},"You want to add an item only at the end",[158,1013,1014],{},"You do not need to choose a position",[20,1016,230],{},[46,1018,1020],{"className":48,"code":1019,"language":50,"meta":51,"style":51},"items = [\"apple\", \"orange\"]\n\nitems.insert(1, \"banana\")\nprint(items)\n\nitems.append(\"grape\")\nprint(items)\n",[15,1021,1022,1049,1053,1077,1087,1091,1112],{"__ignoreMap":51},[55,1023,1024,1027,1029,1031,1033,1036,1038,1040,1042,1045,1047],{"class":57,"line":58},[55,1025,1026],{"class":61},"items ",[55,1028,66],{"class":65},[55,1030,70],{"class":69},[55,1032,248],{"class":247},[55,1034,1035],{"class":251},"apple",[55,1037,248],{"class":247},[55,1039,77],{"class":69},[55,1041,258],{"class":247},[55,1043,1044],{"class":251},"orange",[55,1046,248],{"class":247},[55,1048,88],{"class":69},[55,1050,1051],{"class":57,"line":91},[55,1052,429],{"emptyLinePlaceholder":428},[55,1054,1055,1058,1060,1062,1064,1066,1068,1070,1073,1075],{"class":57,"line":117},[55,1056,1057],{"class":61},"items",[55,1059,44],{"class":69},[55,1061,100],{"class":99},[55,1063,103],{"class":69},[55,1065,74],{"class":73},[55,1067,77],{"class":69},[55,1069,258],{"class":247},[55,1071,1072],{"class":251},"banana",[55,1074,248],{"class":247},[55,1076,114],{"class":69},[55,1078,1079,1081,1083,1085],{"class":57,"line":130},[55,1080,121],{"class":120},[55,1082,103],{"class":69},[55,1084,1057],{"class":99},[55,1086,114],{"class":69},[55,1088,1089],{"class":57,"line":456},[55,1090,429],{"emptyLinePlaceholder":428},[55,1092,1094,1096,1098,1101,1103,1105,1108,1110],{"class":57,"line":1093},6,[55,1095,1057],{"class":61},[55,1097,44],{"class":69},[55,1099,1100],{"class":99},"append",[55,1102,103],{"class":69},[55,1104,248],{"class":247},[55,1106,1107],{"class":251},"grape",[55,1109,248],{"class":247},[55,1111,114],{"class":69},[55,1113,1115,1117,1119,1121],{"class":57,"line":1114},7,[55,1116,121],{"class":120},[55,1118,103],{"class":69},[55,1120,1057],{"class":99},[55,1122,114],{"class":69},[20,1124,302],{},[46,1126,1128],{"className":48,"code":1127,"language":50,"meta":51,"style":51},"['apple', 'banana', 'orange']\n['apple', 'banana', 'orange', 'grape']\n",[15,1129,1130,1158],{"__ignoreMap":51},[55,1131,1132,1134,1136,1138,1140,1142,1144,1146,1148,1150,1152,1154,1156],{"class":57,"line":58},[55,1133,312],{"class":69},[55,1135,315],{"class":247},[55,1137,1035],{"class":251},[55,1139,315],{"class":247},[55,1141,77],{"class":69},[55,1143,324],{"class":247},[55,1145,1072],{"class":251},[55,1147,315],{"class":247},[55,1149,77],{"class":69},[55,1151,324],{"class":247},[55,1153,1044],{"class":251},[55,1155,315],{"class":247},[55,1157,88],{"class":69},[55,1159,1160,1162,1164,1166,1168,1170,1172,1174,1176,1178,1180,1182,1184,1186,1188,1190,1192],{"class":57,"line":91},[55,1161,312],{"class":69},[55,1163,315],{"class":247},[55,1165,1035],{"class":251},[55,1167,315],{"class":247},[55,1169,77],{"class":69},[55,1171,324],{"class":247},[55,1173,1072],{"class":251},[55,1175,315],{"class":247},[55,1177,77],{"class":69},[55,1179,324],{"class":247},[55,1181,1044],{"class":251},[55,1183,315],{"class":247},[55,1185,77],{"class":69},[55,1187,324],{"class":247},[55,1189,1107],{"class":251},[55,1191,315],{"class":247},[55,1193,88],{"class":69},[20,1195,1196,1197,44],{},"For the full method details, see the ",[36,1198,39,1199,43],{"href":38},[15,1200,42],{},[20,1202,1203,1204,44],{},"If your goal is the task itself rather than the method details, see ",[36,1205,1207],{"href":1206},"\u002Fhow-to\u002Fhow-to-add-an-item-to-a-list-in-python\u002F","how to add an item to a list in Python",[142,1209,1211],{"id":1210},"common-beginner-mistakes","Common beginner mistakes",[20,1213,1214,1215,44],{},"Here are some common problems beginners run into with ",[15,1216,17],{},[577,1218,1220,1221],{"id":1219},"assigning-the-result-of-insert","Assigning the result of ",[15,1222,17],{},[20,1224,1225],{},"This is a very common mistake:",[46,1227,1229],{"className":48,"code":1228,"language":50,"meta":51,"style":51},"numbers = [1, 2, 3]\nresult = numbers.insert(1, 99)\n\nprint(result)\nprint(numbers)\n",[15,1230,1231,1251,1276,1280,1291],{"__ignoreMap":51},[55,1232,1233,1235,1237,1239,1241,1243,1245,1247,1249],{"class":57,"line":58},[55,1234,62],{"class":61},[55,1236,66],{"class":65},[55,1238,70],{"class":69},[55,1240,74],{"class":73},[55,1242,77],{"class":69},[55,1244,80],{"class":73},[55,1246,77],{"class":69},[55,1248,111],{"class":73},[55,1250,88],{"class":69},[55,1252,1253,1256,1258,1261,1263,1265,1267,1269,1271,1274],{"class":57,"line":91},[55,1254,1255],{"class":61},"result ",[55,1257,66],{"class":65},[55,1259,1260],{"class":61}," numbers",[55,1262,44],{"class":69},[55,1264,100],{"class":99},[55,1266,103],{"class":69},[55,1268,74],{"class":73},[55,1270,77],{"class":69},[55,1272,1273],{"class":73}," 99",[55,1275,114],{"class":69},[55,1277,1278],{"class":57,"line":117},[55,1279,429],{"emptyLinePlaceholder":428},[55,1281,1282,1284,1286,1289],{"class":57,"line":130},[55,1283,121],{"class":120},[55,1285,103],{"class":69},[55,1287,1288],{"class":99},"result",[55,1290,114],{"class":69},[55,1292,1293,1295,1297,1299],{"class":57,"line":456},[55,1294,121],{"class":120},[55,1296,103],{"class":69},[55,1298,94],{"class":99},[55,1300,114],{"class":69},[20,1302,302],{},[46,1304,1306],{"className":48,"code":1305,"language":50,"meta":51,"style":51},"None\n[1, 99, 2, 3]\n",[15,1307,1308,1314],{"__ignoreMap":51},[55,1309,1310],{"class":57,"line":58},[55,1311,1313],{"class":1312},"s39Yj","None\n",[55,1315,1316,1318,1320,1322,1324,1326,1328,1330,1332],{"class":57,"line":91},[55,1317,312],{"class":69},[55,1319,74],{"class":73},[55,1321,77],{"class":69},[55,1323,1273],{"class":73},[55,1325,77],{"class":69},[55,1327,80],{"class":73},[55,1329,77],{"class":69},[55,1331,111],{"class":73},[55,1333,88],{"class":69},[20,1335,1336,1338,1339,44],{},[15,1337,17],{}," changes the original list and returns ",[15,1340,172],{},[20,1342,1343],{},"Wrong:",[46,1345,1347],{"className":48,"code":1346,"language":50,"meta":51,"style":51},"new_list = numbers.insert(1, 99)\n",[15,1348,1349],{"__ignoreMap":51},[55,1350,1351,1354,1356,1358,1360,1362,1364,1366,1368,1370],{"class":57,"line":58},[55,1352,1353],{"class":61},"new_list ",[55,1355,66],{"class":65},[55,1357,1260],{"class":61},[55,1359,44],{"class":69},[55,1361,100],{"class":99},[55,1363,103],{"class":69},[55,1365,74],{"class":73},[55,1367,77],{"class":69},[55,1369,1273],{"class":73},[55,1371,114],{"class":69},[20,1373,1374],{},"Right:",[46,1376,1378],{"className":48,"code":1377,"language":50,"meta":51,"style":51},"numbers.insert(1, 99)\n",[15,1379,1380],{"__ignoreMap":51},[55,1381,1382,1384,1386,1388,1390,1392,1394,1396],{"class":57,"line":58},[55,1383,94],{"class":61},[55,1385,44],{"class":69},[55,1387,100],{"class":99},[55,1389,103],{"class":69},[55,1391,74],{"class":73},[55,1393,77],{"class":69},[55,1395,1273],{"class":73},[55,1397,114],{"class":69},[577,1399,1401],{"id":1400},"passing-arguments-in-the-wrong-order","Passing arguments in the wrong order",[20,1403,1404],{},"The correct order is:",[46,1406,1407],{"className":48,"code":185,"language":50,"meta":51,"style":51},[15,1408,1409],{"__ignoreMap":51},[55,1410,1411,1413,1415,1417,1419,1421,1423,1425],{"class":57,"line":58},[55,1412,192],{"class":61},[55,1414,44],{"class":69},[55,1416,100],{"class":99},[55,1418,103],{"class":69},[55,1420,201],{"class":99},[55,1422,77],{"class":69},[55,1424,206],{"class":99},[55,1426,114],{"class":69},[20,1428,1429],{},"Not:",[46,1431,1433],{"className":48,"code":1432,"language":50,"meta":51,"style":51},"my_list.insert(item, index)\n",[15,1434,1435],{"__ignoreMap":51},[55,1436,1437,1439,1441,1443,1445,1447,1449,1452],{"class":57,"line":58},[55,1438,192],{"class":61},[55,1440,44],{"class":69},[55,1442,100],{"class":99},[55,1444,103],{"class":69},[55,1446,220],{"class":99},[55,1448,77],{"class":69},[55,1450,1451],{"class":99}," index",[55,1453,114],{"class":69},[20,1455,230],{},[46,1457,1458],{"className":48,"code":233,"language":50,"meta":51,"style":51},[15,1459,1460,1484,1506],{"__ignoreMap":51},[55,1461,1462,1464,1466,1468,1470,1472,1474,1476,1478,1480,1482],{"class":57,"line":58},[55,1463,240],{"class":61},[55,1465,66],{"class":65},[55,1467,70],{"class":69},[55,1469,248],{"class":247},[55,1471,36],{"class":251},[55,1473,248],{"class":247},[55,1475,77],{"class":69},[55,1477,258],{"class":247},[55,1479,261],{"class":251},[55,1481,248],{"class":247},[55,1483,88],{"class":69},[55,1485,1486,1488,1490,1492,1494,1496,1498,1500,1502,1504],{"class":57,"line":91},[55,1487,270],{"class":61},[55,1489,44],{"class":69},[55,1491,100],{"class":99},[55,1493,103],{"class":69},[55,1495,74],{"class":73},[55,1497,77],{"class":69},[55,1499,258],{"class":247},[55,1501,285],{"class":251},[55,1503,248],{"class":247},[55,1505,114],{"class":69},[55,1507,1508,1510,1512,1514],{"class":57,"line":117},[55,1509,121],{"class":120},[55,1511,103],{"class":69},[55,1513,270],{"class":99},[55,1515,114],{"class":69},[20,1517,302],{},[46,1519,1520],{"className":48,"code":305,"language":50,"meta":51,"style":51},[15,1521,1522],{"__ignoreMap":51},[55,1523,1524,1526,1528,1530,1532,1534,1536,1538,1540,1542,1544,1546,1548],{"class":57,"line":58},[55,1525,312],{"class":69},[55,1527,315],{"class":247},[55,1529,36],{"class":251},[55,1531,315],{"class":247},[55,1533,77],{"class":69},[55,1535,324],{"class":247},[55,1537,285],{"class":251},[55,1539,315],{"class":247},[55,1541,77],{"class":69},[55,1543,324],{"class":247},[55,1545,261],{"class":251},[55,1547,315],{"class":247},[55,1549,88],{"class":69},[577,1551,1553,1554,1556],{"id":1552},"expecting-insert-to-replace-an-item","Expecting ",[15,1555,17],{}," to replace an item",[20,1558,1559,1561],{},[15,1560,17],{}," does not replace an existing value. It shifts items to the right.",[46,1563,1565],{"className":48,"code":1564,"language":50,"meta":51,"style":51},"numbers = [1, 2, 3]\nnumbers.insert(1, 99)\nprint(numbers)\n",[15,1566,1567,1587,1605],{"__ignoreMap":51},[55,1568,1569,1571,1573,1575,1577,1579,1581,1583,1585],{"class":57,"line":58},[55,1570,62],{"class":61},[55,1572,66],{"class":65},[55,1574,70],{"class":69},[55,1576,74],{"class":73},[55,1578,77],{"class":69},[55,1580,80],{"class":73},[55,1582,77],{"class":69},[55,1584,111],{"class":73},[55,1586,88],{"class":69},[55,1588,1589,1591,1593,1595,1597,1599,1601,1603],{"class":57,"line":91},[55,1590,94],{"class":61},[55,1592,44],{"class":69},[55,1594,100],{"class":99},[55,1596,103],{"class":69},[55,1598,74],{"class":73},[55,1600,77],{"class":69},[55,1602,1273],{"class":73},[55,1604,114],{"class":69},[55,1606,1607,1609,1611,1613],{"class":57,"line":117},[55,1608,121],{"class":120},[55,1610,103],{"class":69},[55,1612,94],{"class":99},[55,1614,114],{"class":69},[20,1616,302],{},[46,1618,1620],{"className":48,"code":1619,"language":50,"meta":51,"style":51},"[1, 99, 2, 3]\n",[15,1621,1622],{"__ignoreMap":51},[55,1623,1624,1626,1628,1630,1632,1634,1636,1638,1640],{"class":57,"line":58},[55,1625,312],{"class":69},[55,1627,74],{"class":73},[55,1629,77],{"class":69},[55,1631,1273],{"class":73},[55,1633,77],{"class":69},[55,1635,80],{"class":73},[55,1637,77],{"class":69},[55,1639,111],{"class":73},[55,1641,88],{"class":69},[20,1643,1644],{},"If you want to replace a value instead, use assignment:",[46,1646,1648],{"className":48,"code":1647,"language":50,"meta":51,"style":51},"numbers = [1, 2, 3]\nnumbers[1] = 99\nprint(numbers)\n",[15,1649,1650,1670,1687],{"__ignoreMap":51},[55,1651,1652,1654,1656,1658,1660,1662,1664,1666,1668],{"class":57,"line":58},[55,1653,62],{"class":61},[55,1655,66],{"class":65},[55,1657,70],{"class":69},[55,1659,74],{"class":73},[55,1661,77],{"class":69},[55,1663,80],{"class":73},[55,1665,77],{"class":69},[55,1667,111],{"class":73},[55,1669,88],{"class":69},[55,1671,1672,1674,1676,1678,1681,1684],{"class":57,"line":91},[55,1673,94],{"class":61},[55,1675,312],{"class":69},[55,1677,74],{"class":73},[55,1679,1680],{"class":69},"]",[55,1682,1683],{"class":65}," =",[55,1685,1686],{"class":73}," 99\n",[55,1688,1689,1691,1693,1695],{"class":57,"line":117},[55,1690,121],{"class":120},[55,1692,103],{"class":69},[55,1694,94],{"class":99},[55,1696,114],{"class":69},[20,1698,302],{},[46,1700,1702],{"className":48,"code":1701,"language":50,"meta":51,"style":51},"[1, 99, 3]\n",[15,1703,1704],{"__ignoreMap":51},[55,1705,1706,1708,1710,1712,1714,1716,1718],{"class":57,"line":58},[55,1707,312],{"class":69},[55,1709,74],{"class":73},[55,1711,77],{"class":69},[55,1713,1273],{"class":73},[55,1715,77],{"class":69},[55,1717,111],{"class":73},[55,1719,88],{"class":69},[577,1721,1723],{"id":1722},"trying-to-insert-multiple-items-at-once","Trying to insert multiple items at once",[20,1725,1726,1728],{},[15,1727,17],{}," adds one item each time.",[20,1730,1731],{},"This inserts a single list as one item:",[46,1733,1735],{"className":48,"code":1734,"language":50,"meta":51,"style":51},"numbers = [1, 4]\nnumbers.insert(1, [2, 3])\nprint(numbers)\n",[15,1736,1737,1753,1778],{"__ignoreMap":51},[55,1738,1739,1741,1743,1745,1747,1749,1751],{"class":57,"line":58},[55,1740,62],{"class":61},[55,1742,66],{"class":65},[55,1744,70],{"class":69},[55,1746,74],{"class":73},[55,1748,77],{"class":69},[55,1750,85],{"class":73},[55,1752,88],{"class":69},[55,1754,1755,1757,1759,1761,1763,1765,1767,1769,1771,1773,1775],{"class":57,"line":91},[55,1756,94],{"class":61},[55,1758,44],{"class":69},[55,1760,100],{"class":99},[55,1762,103],{"class":69},[55,1764,74],{"class":73},[55,1766,77],{"class":69},[55,1768,70],{"class":69},[55,1770,106],{"class":73},[55,1772,77],{"class":69},[55,1774,111],{"class":73},[55,1776,1777],{"class":69},"])\n",[55,1779,1780,1782,1784,1786],{"class":57,"line":117},[55,1781,121],{"class":120},[55,1783,103],{"class":69},[55,1785,94],{"class":99},[55,1787,114],{"class":69},[20,1789,302],{},[46,1791,1793],{"className":48,"code":1792,"language":50,"meta":51,"style":51},"[1, [2, 3], 4]\n",[15,1794,1795],{"__ignoreMap":51},[55,1796,1797,1799,1801,1803,1805,1807,1809,1811,1814,1816],{"class":57,"line":58},[55,1798,312],{"class":69},[55,1800,74],{"class":73},[55,1802,77],{"class":69},[55,1804,70],{"class":69},[55,1806,106],{"class":73},[55,1808,77],{"class":69},[55,1810,111],{"class":73},[55,1812,1813],{"class":69},"],",[55,1815,85],{"class":73},[55,1817,88],{"class":69},[20,1819,1820,1821,44],{},"If you want to add many items, see the ",[36,1822,39,1824,43],{"href":1823},"\u002Freference\u002Fpython-list-extend-method\u002F",[15,1825,1826],{},"extend()",[577,1828,1830],{"id":1829},"helpful-checks-while-debugging","Helpful checks while debugging",[20,1832,1833,1834,1836],{},"If ",[15,1835,17],{}," is not doing what you expect, these can help:",[46,1838,1840],{"className":48,"code":1839,"language":50,"meta":51,"style":51},"print(my_list)\nprint(len(my_list))\nprint(my_list.insert.__doc__)\nhelp(list.insert)\ntype(my_list)\n",[15,1841,1842,1852,1868,1889,1906],{"__ignoreMap":51},[55,1843,1844,1846,1848,1850],{"class":57,"line":58},[55,1845,121],{"class":120},[55,1847,103],{"class":69},[55,1849,192],{"class":99},[55,1851,114],{"class":69},[55,1853,1854,1856,1858,1861,1863,1865],{"class":57,"line":91},[55,1855,121],{"class":120},[55,1857,103],{"class":69},[55,1859,1860],{"class":120},"len",[55,1862,103],{"class":69},[55,1864,192],{"class":99},[55,1866,1867],{"class":69},"))\n",[55,1869,1870,1872,1874,1876,1878,1881,1883,1887],{"class":57,"line":117},[55,1871,121],{"class":120},[55,1873,103],{"class":69},[55,1875,192],{"class":99},[55,1877,44],{"class":69},[55,1879,100],{"class":1880},"skxfh",[55,1882,44],{"class":69},[55,1884,1886],{"class":1885},"s_hVV","__doc__",[55,1888,114],{"class":69},[55,1890,1891,1894,1896,1900,1902,1904],{"class":57,"line":130},[55,1892,1893],{"class":120},"help",[55,1895,103],{"class":69},[55,1897,1899],{"class":1898},"sZMiF","list",[55,1901,44],{"class":69},[55,1903,100],{"class":1880},[55,1905,114],{"class":69},[55,1907,1908,1911,1913,1915],{"class":57,"line":456},[55,1909,1910],{"class":1898},"type",[55,1912,103],{"class":69},[55,1914,192],{"class":99},[55,1916,114],{"class":69},[20,1918,1919],{},"These checks can help you confirm:",[155,1921,1922,1925,1928,1931],{},[158,1923,1924],{},"What is currently in the list",[158,1926,1927],{},"How long the list is",[158,1929,1930],{},"That you are working with a real list",[158,1932,1933],{},"How Python describes the method",[142,1935,1937,1938],{"id":1936},"when-to-use-insert","When to use ",[15,1939,17],{},[20,1941,31,1942,1944],{},[15,1943,17],{}," when position matters.",[20,1946,1947],{},"Common cases:",[155,1949,1950,1953,1956,1959],{},[158,1951,1952],{},"Ordered menus",[158,1954,1955],{},"Rankings or score lists",[158,1957,1958],{},"Step-by-step manual list building",[158,1960,1961],{},"Inserting a value at the beginning or middle",[20,1963,1964,1965,1969,1970,1972,1973,1975],{},"You usually do ",[1966,1967,1968],"strong",{},"not"," need ",[15,1971,17],{}," when adding only to the end of a list. In that case, ",[15,1974,42],{}," is simpler.",[20,1977,1978,1979,44],{},"If you need a refresher on making lists before using methods on them, see ",[36,1980,1982],{"href":1981},"\u002Freference\u002Fpython-list-creating-a-list\u002F","creating a list in Python",[142,1984,1986],{"id":1985},"faq","FAQ",[577,1988,1990,1991,1993],{"id":1989},"does-listinsert-return-a-new-list","Does ",[15,1992,24],{}," return a new list?",[20,1995,1996,1997,44],{},"No. It changes the existing list and returns ",[15,1998,172],{},[577,2000,2002],{"id":2001},"what-happens-if-the-index-is-bigger-than-the-list-length","What happens if the index is bigger than the list length?",[20,2004,2005],{},"Python adds the item at the end of the list.",[577,2007,2009,2010,2012],{"id":2008},"can-listinsert-add-multiple-items","Can ",[15,2011,24],{}," add multiple items?",[20,2014,2015,2016,2018],{},"It adds one item each time. To add many items, use ",[15,2017,1826],{}," or slicing.",[577,2020,2022,2023,352,2025,2027],{"id":2021},"what-is-the-difference-between-insert-and-append","What is the difference between ",[15,2024,17],{},[15,2026,42],{},"?",[20,2029,2030,2032,2033,2035],{},[15,2031,17],{}," adds at a chosen position. ",[15,2034,42],{}," adds only at the end.",[142,2037,2039],{"id":2038},"see-also","See also",[155,2041,2042,2048,2054,2059,2064,2069],{},[158,2043,2044],{},[36,2045,39,2046,43],{"href":38},[15,2047,42],{},[158,2049,2050],{},[36,2051,39,2052,43],{"href":1823},[15,2053,1826],{},[158,2055,2056],{},[36,2057,2058],{"href":1206},"How to add an item to a list in Python",[158,2060,2061],{},[36,2062,2063],{"href":974},"Python lists explained for beginners",[158,2065,2066],{},[36,2067,2068],{"href":1981},"Creating a list in Python",[158,2070,2071],{},[36,2072,2074,2075,2078],{"href":2073},"\u002Ferrors\u002Fattributeerror-list-object-has-no-attribute-fix\u002F","Fix ",[15,2076,2077],{},"'list' object has no attribute ..."," errors",[2080,2081,2082],"style",{},"html pre.shiki code .su5hD, html code.shiki .su5hD{--shiki-light:#90A4AE;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .smGrS, html code.shiki .smGrS{--shiki-light:#39ADB5;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sP7_E, html code.shiki .sP7_E{--shiki-light:#39ADB5;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .srdBf, html code.shiki .srdBf{--shiki-light:#F76D47;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .slqww, html code.shiki .slqww{--shiki-light:#6182B8;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sptTA, html code.shiki .sptTA{--shiki-light:#6182B8;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sutJx, html code.shiki .sutJx{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#6A737D;--shiki-default-font-style:inherit;--shiki-dark:#6A737D;--shiki-dark-font-style:inherit}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sjJ54, html code.shiki .sjJ54{--shiki-light:#39ADB5;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .s_sjI, html code.shiki .s_sjI{--shiki-light:#91B859;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .s39Yj, html code.shiki .s39Yj{--shiki-light:#39ADB5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .skxfh, html code.shiki .skxfh{--shiki-light:#E53935;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s_hVV, html code.shiki .s_hVV{--shiki-light:#90A4AE;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZMiF, html code.shiki .sZMiF{--shiki-light:#E2931D;--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":51,"searchDepth":91,"depth":91,"links":2084},[2085,2087,2088,2089,2095,2102,2111,2113,2122],{"id":144,"depth":91,"text":2086},"What list.insert() does",{"id":181,"depth":91,"text":182},{"id":358,"depth":91,"text":359},{"id":564,"depth":91,"text":565,"children":2090},[2091,2092,2093,2094],{"id":579,"depth":117,"text":580},{"id":672,"depth":117,"text":673},{"id":758,"depth":117,"text":759},{"id":845,"depth":117,"text":846},{"id":979,"depth":91,"text":2096,"children":2097},"insert() vs append()",[2098,2100],{"id":990,"depth":117,"text":2099},"Use insert() when:",{"id":1004,"depth":117,"text":2101},"Use append() when:",{"id":1210,"depth":91,"text":1211,"children":2103},[2104,2106,2107,2109,2110],{"id":1219,"depth":117,"text":2105},"Assigning the result of insert()",{"id":1400,"depth":117,"text":1401},{"id":1552,"depth":117,"text":2108},"Expecting insert() to replace an item",{"id":1722,"depth":117,"text":1723},{"id":1829,"depth":117,"text":1830},{"id":1936,"depth":91,"text":2112},"When to use insert()",{"id":1985,"depth":91,"text":1986,"children":2114},[2115,2117,2118,2120],{"id":1989,"depth":117,"text":2116},"Does list.insert() return a new list?",{"id":2001,"depth":117,"text":2002},{"id":2008,"depth":117,"text":2119},"Can list.insert() add multiple items?",{"id":2021,"depth":117,"text":2121},"What is the difference between insert() and append()?",{"id":2038,"depth":91,"text":2039},"Master python list insert method in our comprehensive Python beginner guide.","md",{},"\u002Freference\u002Fpython-list-insert-method",{"title":5,"description":2123},"reference\u002Fpython-list-insert-method","x_dK_NYzoYQLOwms5BtRdF_-FqYStoiPzy7EKR6Cd44",1777585513026]