René's URL Explorer Experiment


Title: Add full alt-text (title and description) support for pictures and inline shapes by EwoutH · Pull Request #1530 · python-openxml/python-docx · GitHub

Open Graph Title: Add full alt-text (title and description) support for pictures and inline shapes by EwoutH · Pull Request #1530 · python-openxml/python-docx

X Title: Add full alt-text (title and description) support for pictures and inline shapes by EwoutH · Pull Request #1530 · python-openxml/python-docx

Description: Builds on #227 and #317. Summary This PR introduces first-class support for Word Alt Text in python-docx. Users can now set and read both the Alt Text Title and Alt Text Description (as shown in Word’s Accessibility pane) directly through the API when inserting or editing pictures. Motive Previously, python-docx did not expose a clean API for working with image alternative text. Users had to manually manipulate XML to set or retrieve attributes (title, descr). This enhancement improves accessibility workflows and enables automated tools (e.g., alt-text generators) to embed compliant descriptions directly into Word documents. Implementation CT_NonVisualDrawingProps (oxml/shape.py): Added optional attributes title and descr. CT_Inline.new() / new_pic_inline(): Accept and apply title / descr to . StoryPart.new_pic_inline(): Added title and descr parameters and forwarded them to CT_Inline.new_pic_inline(). Run.add_picture() and Document.add_picture(): Updated to accept and pass through title and descr for inline pictures. InlineShape (shape.py): Added new alt_text and alt_title properties for convenient read/write access to docPr.descr and docPr.title. Usage Examples from docx import Document from docx.shared import Inches doc = Document() # Insert an image with alt text doc.add_picture( "chart.png", width=Inches(5), descr="Line chart showing sales growth from 2020 to 2024.", title="Sales Growth Chart" ) # Access or modify alt text of an existing shape shape = doc.inline_shapes[0] print(shape.alt_text) # "Line chart showing sales growth from 2020 to 2024." shape.alt_text = "Updated alt text description." shape.alt_title = "Updated title." doc.save("report_with_alt_text.docx") Additional Notes Verified functionality using a test script that inserted an image, saved, reloaded, and confirmed alt_title and alt_text persisted correctly. No breaking API changes; title and descr are optional. Works across all story parts (document, headers, footers). Backwards compatible with existing documents. Enables accessibility tooling, automated captioning, and alt-text validation in Word documents.

Open Graph Description: Builds on #227 and #317. Summary This PR introduces first-class support for Word Alt Text in python-docx. Users can now set and read both the Alt Text Title and Alt Text Description (as shown in Wo...

X Description: Builds on #227 and #317. Summary This PR introduces first-class support for Word Alt Text in python-docx. Users can now set and read both the Alt Text Title and Alt Text Description (as shown in Wo...

Opengraph URL: https://github.com/python-openxml/python-docx/pull/1530

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:aa1c76ed-81a0-44b0-290d-55eb862cfc82
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idB6CC:18D1D3:8F3457C:BD1FD30:696DF43C
html-safe-nonce9a6c25787924c30699331fa7112a53bb3d4f5ad1e5dac47a735a80cd76c3f2d2
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCNkNDOjE4RDFEMzo4RjM0NTdDOkJEMUZEMzA6Njk2REY0M0MiLCJ2aXNpdG9yX2lkIjoiMjQzODA2NDE0NDg2NTAwNDEyIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac32e9e178d4617285a122f369dfa7ae0c5d68b8c13b94fdfbcf4930c0fe58f545
hovercard-subject-tagpull_request:2995372904
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/python-openxml/python-docx/pull/1530/files
twitter:imagehttps://avatars.githubusercontent.com/u/15776622?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/15776622?s=400&v=4
og:image:altBuilds on #227 and #317. Summary This PR introduces first-class support for Word Alt Text in python-docx. Users can now set and read both the Alt Text Title and Alt Text Description (as shown in Wo...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None4922b452d03cd8dbce479d866a11bc25b59ef6ee2da23aa9b0ddefa6bd4d0064
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/python-openxml/python-docx git https://github.com/python-openxml/python-docx.git
octolytics-dimension-user_id3403760
octolytics-dimension-user_loginpython-openxml
octolytics-dimension-repository_id13592924
octolytics-dimension-repository_nwopython-openxml/python-docx
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id13592924
octolytics-dimension-repository_network_root_nwopython-openxml/python-docx
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release7e5ae23c70136152637ceee8d6faceb35596ec46
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/python-openxml/python-docx/pull/1530/files#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython-openxml%2Fpython-docx%2Fpull%2F1530%2Ffiles
GitHub CopilotWrite better code with AIhttps://github.com/features/copilot
GitHub SparkBuild and deploy intelligent appshttps://github.com/features/spark
GitHub ModelsManage and compare promptshttps://github.com/features/models
MCP RegistryNewIntegrate external toolshttps://github.com/mcp
ActionsAutomate any workflowhttps://github.com/features/actions
CodespacesInstant dev environmentshttps://github.com/features/codespaces
IssuesPlan and track workhttps://github.com/features/issues
Code ReviewManage code changeshttps://github.com/features/code-review
GitHub Advanced SecurityFind and fix vulnerabilitieshttps://github.com/security/advanced-security
Code securitySecure your code as you buildhttps://github.com/security/advanced-security/code-security
Secret protectionStop leaks before they starthttps://github.com/security/advanced-security/secret-protection
Why GitHubhttps://github.com/why-github
Documentationhttps://docs.github.com
Bloghttps://github.blog
Changeloghttps://github.blog/changelog
Marketplacehttps://github.com/marketplace
View all featureshttps://github.com/features
Enterpriseshttps://github.com/enterprise
Small and medium teamshttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
App Modernizationhttps://github.com/solutions/use-case/app-modernization
DevSecOpshttps://github.com/solutions/use-case/devsecops
DevOpshttps://github.com/solutions/use-case/devops
CI/CDhttps://github.com/solutions/use-case/ci-cd
View all use caseshttps://github.com/solutions/use-case
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
View all industrieshttps://github.com/solutions/industry
View all solutionshttps://github.com/solutions
AIhttps://github.com/resources/articles?topic=ai
Software Developmenthttps://github.com/resources/articles?topic=software-development
DevOpshttps://github.com/resources/articles?topic=devops
Securityhttps://github.com/resources/articles?topic=security
View all topicshttps://github.com/resources/articles
Customer storieshttps://github.com/customer-stories
Events & webinarshttps://github.com/resources/events
Ebooks & reportshttps://github.com/resources/whitepapers
Business insightshttps://github.com/solutions/executive-insights
GitHub Skillshttps://skills.github.com
Documentationhttps://docs.github.com
Customer supporthttps://support.github.com
Community forumhttps://github.com/orgs/community/discussions
Trust centerhttps://github.com/trust-center
Partnershttps://github.com/partners
GitHub SponsorsFund open source developershttps://github.com/sponsors
Security Labhttps://securitylab.github.com
Maintainer Communityhttps://maintainers.github.com
Acceleratorhttps://github.com/accelerator
Archive Programhttps://archiveprogram.github.com
Topicshttps://github.com/topics
Trendinghttps://github.com/trending
Collectionshttps://github.com/collections
Enterprise platformAI-powered developer platformhttps://github.com/enterprise
GitHub Advanced SecurityEnterprise-grade security featureshttps://github.com/security/advanced-security
Copilot for BusinessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/premium-support
Pricinghttps://github.com/pricing
Search syntax tipshttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
documentationhttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython-openxml%2Fpython-docx%2Fpull%2F1530%2Ffiles
Sign up https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=python-openxml%2Fpython-docx
Reloadhttps://github.com/python-openxml/python-docx/pull/1530/files
Reloadhttps://github.com/python-openxml/python-docx/pull/1530/files
Reloadhttps://github.com/python-openxml/python-docx/pull/1530/files
python-openxml https://github.com/python-openxml
python-docxhttps://github.com/python-openxml/python-docx
Notifications https://github.com/login?return_to=%2Fpython-openxml%2Fpython-docx
Fork 1.3k https://github.com/login?return_to=%2Fpython-openxml%2Fpython-docx
Star 5.4k https://github.com/login?return_to=%2Fpython-openxml%2Fpython-docx
Code https://github.com/python-openxml/python-docx
Issues 577 https://github.com/python-openxml/python-docx/issues
Pull requests 121 https://github.com/python-openxml/python-docx/pulls
Actions https://github.com/python-openxml/python-docx/actions
Projects 0 https://github.com/python-openxml/python-docx/projects
Wiki https://github.com/python-openxml/python-docx/wiki
Security Uh oh! There was an error while loading. Please reload this page. https://github.com/python-openxml/python-docx/security
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1530/files
Insights https://github.com/python-openxml/python-docx/pulse
Code https://github.com/python-openxml/python-docx
Issues https://github.com/python-openxml/python-docx/issues
Pull requests https://github.com/python-openxml/python-docx/pulls
Actions https://github.com/python-openxml/python-docx/actions
Projects https://github.com/python-openxml/python-docx/projects
Wiki https://github.com/python-openxml/python-docx/wiki
Security https://github.com/python-openxml/python-docx/security
Insights https://github.com/python-openxml/python-docx/pulse
Sign up for GitHub https://github.com/signup?return_to=%2Fpython-openxml%2Fpython-docx%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fpython-openxml%2Fpython-docx%2Fissues%2Fnew%2Fchoose
EwoutHhttps://github.com/EwoutH
python-openxml:masterhttps://github.com/python-openxml/python-docx/tree/master
EwoutH:althttps://github.com/EwoutH/python-docx/tree/alt
Conversation 1 https://github.com/python-openxml/python-docx/pull/1530
Commits 3 https://github.com/python-openxml/python-docx/pull/1530/commits
Checks 0 https://github.com/python-openxml/python-docx/pull/1530/checks
Files changed https://github.com/python-openxml/python-docx/pull/1530/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1530/files
Add full alt-text (title and description) support for pictures and inline shapes https://github.com/python-openxml/python-docx/pull/1530/files#top
Show all changes 3 commits https://github.com/python-openxml/python-docx/pull/1530/files
794474e oxml: add optional `title` and `descr` attributes to CT_NonVisualDraw… EwoutH Nov 10, 2025 https://github.com/python-openxml/python-docx/pull/1530/commits/794474e425f450b90ee8014c92b63e63e3d8c1f2
d46a198 feat: add alt-text support for images in StoryPart and Run EwoutH Nov 10, 2025 https://github.com/python-openxml/python-docx/pull/1530/commits/d46a19814fe103d7635870e510dedc394b8ff9ba
74bebf6 feat(shape): add alt_text and alt_title properties to InlineShape EwoutH Nov 10, 2025 https://github.com/python-openxml/python-docx/pull/1530/commits/74bebf65bb0549df9388dc84a5ff622133875861
Clear filters https://github.com/python-openxml/python-docx/pull/1530/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1530/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1530/files
document.py https://github.com/python-openxml/python-docx/pull/1530/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
shape.py https://github.com/python-openxml/python-docx/pull/1530/files#diff-44d8a3691bb9e00e36a40a46fc29417f56a4a8e55082bbeb5fc143199f0c834b
story.py https://github.com/python-openxml/python-docx/pull/1530/files#diff-ba91bb830fd1ea6cad2c33712d5a7c8b7d827109abf3529134d376d8fe583da0
shape.py https://github.com/python-openxml/python-docx/pull/1530/files#diff-cd4e5f67ccc49a96300e5195ddd86dd61c498b4738b24f31f956065f4081c990
run.py https://github.com/python-openxml/python-docx/pull/1530/files#diff-93a63e78713879c0fd787128dfc3a563806eff684b68e9ba3a3fd0cd11e47e45
src/docx/document.pyhttps://github.com/python-openxml/python-docx/pull/1530/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
View file https://github.com/python-openxml/python-docx/blob/74bebf65bb0549df9388dc84a5ff622133875861/src/docx/document.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1530/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1530/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
https://github.com/python-openxml/python-docx/pull/1530/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
https://github.com/python-openxml/python-docx/pull/1530/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
src/docx/oxml/shape.pyhttps://github.com/python-openxml/python-docx/pull/1530/files#diff-44d8a3691bb9e00e36a40a46fc29417f56a4a8e55082bbeb5fc143199f0c834b
View file https://github.com/python-openxml/python-docx/blob/74bebf65bb0549df9388dc84a5ff622133875861/src/docx/oxml/shape.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1530/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1530/files#diff-44d8a3691bb9e00e36a40a46fc29417f56a4a8e55082bbeb5fc143199f0c834b
https://github.com/python-openxml/python-docx/pull/1530/files#diff-44d8a3691bb9e00e36a40a46fc29417f56a4a8e55082bbeb5fc143199f0c834b
https://github.com/python-openxml/python-docx/pull/1530/files#diff-44d8a3691bb9e00e36a40a46fc29417f56a4a8e55082bbeb5fc143199f0c834b
src/docx/parts/story.pyhttps://github.com/python-openxml/python-docx/pull/1530/files#diff-ba91bb830fd1ea6cad2c33712d5a7c8b7d827109abf3529134d376d8fe583da0
View file https://github.com/python-openxml/python-docx/blob/74bebf65bb0549df9388dc84a5ff622133875861/src/docx/parts/story.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1530/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1530/files#diff-ba91bb830fd1ea6cad2c33712d5a7c8b7d827109abf3529134d376d8fe583da0
https://github.com/python-openxml/python-docx/pull/1530/files#diff-ba91bb830fd1ea6cad2c33712d5a7c8b7d827109abf3529134d376d8fe583da0
https://github.com/python-openxml/python-docx/pull/1530/files#diff-ba91bb830fd1ea6cad2c33712d5a7c8b7d827109abf3529134d376d8fe583da0
src/docx/shape.pyhttps://github.com/python-openxml/python-docx/pull/1530/files#diff-cd4e5f67ccc49a96300e5195ddd86dd61c498b4738b24f31f956065f4081c990
View file https://github.com/python-openxml/python-docx/blob/74bebf65bb0549df9388dc84a5ff622133875861/src/docx/shape.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1530/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1530/files#diff-cd4e5f67ccc49a96300e5195ddd86dd61c498b4738b24f31f956065f4081c990
src/docx/text/run.pyhttps://github.com/python-openxml/python-docx/pull/1530/files#diff-93a63e78713879c0fd787128dfc3a563806eff684b68e9ba3a3fd0cd11e47e45
View file https://github.com/python-openxml/python-docx/blob/74bebf65bb0549df9388dc84a5ff622133875861/src/docx/text/run.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1530/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1530/files#diff-93a63e78713879c0fd787128dfc3a563806eff684b68e9ba3a3fd0cd11e47e45
https://github.com/python-openxml/python-docx/pull/1530/files#diff-93a63e78713879c0fd787128dfc3a563806eff684b68e9ba3a3fd0cd11e47e45
https://github.com/python-openxml/python-docx/pull/1530/files#diff-93a63e78713879c0fd787128dfc3a563806eff684b68e9ba3a3fd0cd11e47e45
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width

URLs of crawlers that visited me.