René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Feature Request: Add Hyperlinks With Multiple Runs","articleBody":"I need to be able to add hyperlinks with multiple runs to paragraphs. Right now I am able to achieve this like so:\n```\nfrom docx.oxml.shared import OxmlElement, qn\nfrom docx.opc.constants import RELATIONSHIP_TYPE\nfrom docx import Document\nfrom docx.text.run import Run\nfrom docx.shared import RGBColor\n\ndef add_hyperlink(paragraph, address, runs):\n    # Access the document.xml.rels file and get a new relationship type ID\n    part = paragraph.part\n    r_id = part.relate_to(address, RELATIONSHIP_TYPE.HYPERLINK, is_external=True)\n\n    # Create the w:hyperlink tag and add needed properties\n    HYPERLINK_TAG = 'w:hyperlink'\n    RELATIONSHIP_TYPE_ID_PROPERTY = 'r:id'\n    hyperlink = OxmlElement(HYPERLINK_TAG)\n    hyperlink.set(qn(RELATIONSHIP_TYPE_ID_PROPERTY), r_id)\n\n    for run in runs:\n        hyperlink.append(run)\n\n    paragraph._p.append(hyperlink)\n    return hyperlink\n\nRUN_TAG = 'w:r'\nPROPERTIES_TAG = 'w:rPr'\ndocument = Document()\nparagraph = document.add_paragraph()\n\nr1 = OxmlElement(RUN_TAG)\nrPr1 = OxmlElement(PROPERTIES_TAG)\nr1.append(rPr1)\nr1.text = 'Google '\nrun1 = Run(r1, paragraph)\nrun1.underline = True\nrun1.bold = True\nrun1.font.color.rgb = RGBColor(255, 0, 0)\n\nr2 = OxmlElement(RUN_TAG)\nrPr2 = OxmlElement(PROPERTIES_TAG)\nr2.append(rPr2)\nr2.text = 'dot com'\nrun2 = Run(r2, paragraph)\nrun2.underline = True\nrun2.italic = True\nrun2.font.color.rgb = RGBColor(0, 255, 0)\n\nadd_hyperlink(paragraph, 'https://google.com', [run1._r, run2._r])\ndocument.save('new.docx')\n```\nand this produces a hyperlink that looks like this:\n\n\u003cimg width=\"361\" height=\"99\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/735be24b-2949-4847-8e6d-68627326434a\" /\u003e\n\nWould it be possible to extend the API to support adding hyperlinks with different runs? Since hyperlinks are containers for runs, similar to paragraphs, I would imagine the API would look similar to the API for paragraphs. I.e. you can add a hyperlink with text directly:\n```\nhyperlink = paragraph.add_hyperlink('https://google.com', 'Google dot com')\n```\nYou can change the text and address post-factum:\n```\nhyperlink.text = 'Google.com'\nhyperlink.address = 'https://www.google.com'\n```\nOr you can fill the hyperlink incrementally with runs:\n```\nhyperlink = paragraph.add_hyperlink('https://google.com')\nhyperlink.add_run('Google ').bold = True\nhyperlink.add_run('dot com').italic= True\n```\n\nIt would be nice to have this functionality in the API by default. I can try to add it if you tell me what you'd like the API to look like. Thanks in advance!\n","author":{"url":"https://github.com/ptoshkov","@type":"Person","name":"ptoshkov"},"datePublished":"2025-08-31T17:12:17.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/1515/python-docx/issues/1515"}