{"id":92,"date":"2026-03-02T11:17:28","date_gmt":"2026-03-02T03:17:28","guid":{"rendered":"https:\/\/xlwings.net\/blog\/?p=92"},"modified":"2026-01-17T11:09:12","modified_gmt":"2026-01-17T11:09:12","slug":"how-to-add-image-in-the-worksheet-using-xlwings","status":"publish","type":"post","link":"https:\/\/xlwings.net\/blog\/how-to-add-image-in-the-worksheet-using-xlwings\/","title":{"rendered":"How To Add Image In the Worksheet Using xlwings?"},"content":{"rendered":"

Method<\/h2>\n

Use the `AddPicture` method of the `Shape` object to create an image from an existing file. This method returns a `Shape` object representing the new image. The syntax of this method is:<\/p>\n

\u00a0<\/p>\n

sht.api.Shapes.AddPicture(FileName,LinkToFile,SaveWithDocument,Left,Top,Width,Height)<\/p>\n

\u00a0<\/p>\n

Here, `sht` represents the worksheet, and the parameters are as follows:<\/p>\n

\u00a0<\/p>\n

\n\n\n\n\n\n\n\n\n\n\n
\n

Name<\/p>\n<\/td>\n

\n

Required\/Optional<\/p>\n<\/td>\n

\n

Data Type<\/p>\n<\/td>\n

\n

Description<\/p>\n<\/td>\n<\/tr>\n

\n

FileName<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

The image file name<\/p>\n<\/td>\n<\/tr>\n

\n

LinkToFile<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

MsoTriState<\/p>\n<\/td>\n

\n

Set to `False` to make the image an independent copy, not linked. Set to `True` to link the image to the file from which it was created<\/p>\n<\/td>\n<\/tr>\n

\n

SaveWithDocument<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

MsoTriState<\/p>\n<\/td>\n

\n

Saves the image with the document. Use `False` to store only the link information, and `True` to save the linked image with the document. This parameter must be `True` if `LinkToFile` is `False`<\/p>\n<\/td>\n<\/tr>\n

\n

Left<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

Single<\/p>\n<\/td>\n

\n

The position of the top-left corner of the image relative to the document’s top-left corner (in points)<\/p>\n<\/td>\n<\/tr>\n

\n

Top<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

Single<\/p>\n<\/td>\n

\n

The position of the top-left corner of the image relative to the document’s top (in points)<\/p>\n<\/td>\n<\/tr>\n

\n

Width<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

Single<\/p>\n<\/td>\n

\n

The width of the image in points (enter `-1` to retain the original width)<\/p>\n<\/td>\n<\/tr>\n

\n

Height<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

Single<\/p>\n<\/td>\n

\n

The height of the image in points (enter `-1` to retain the original height)<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

\u00a0<\/p>\n

sht.api.Shapes.AddPicture(root+”\/picpy.jpg”, True, True, 100, 50, 100, 100)<\/p>\n

Sample Code<\/h2>\n\n\n
#Add Picture\n\nimport xlwings as xw    #Import xlwings package\nimport os\n\nroot = os.getcwd()\napp=xw.App()\nbk=app.books.active   #Get the active workbook\nsht=bk.sheets.active    #Get the active worksheet\n\nsht.api.Shapes.AddPicture(r\"D:\\picpy.jpg\", True, True, 100, 50, 100, 100)\n\n#bk.save()\n#bk.close()\n#app.kill()<\/code><\/pre>\n\n\n\n
\"Add<\/figure>\n","protected":false},"excerpt":{"rendered":"
Method<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[],"class_list":["post-92","post","type-post","status-publish","format-standard","hentry","category-xlwings-shape"],"_links":{"self":[{"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/posts\/92","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/comments?post=92"}],"version-history":[{"count":3,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/posts\/92\/revisions"}],"predecessor-version":[{"id":464,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/posts\/92\/revisions\/464"}],"wp:attachment":[{"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/media?parent=92"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/categories?post=92"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/tags?post=92"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}