上(shang)官(guan)婉兒是(shi)西(xi)漢上(shang)官(guan)桀、上(shang)官(guan)安、上(shang)官(guan)期祖(zu)孫三代(dai)的后裔，高(gao)祖(zu)父上(shang)官(guan)賢(xian)官(guan)至(zhi)北周幽州太(tai)守，曾祖(zu)父上(shang)官(guan)弘曾在隋朝時(shi)任(ren)江(jiang)都宮(gong)福監，祖(zu)父唐(tang)高(gao)宗時(shi)宰相上(shang)官(guan)儀。
麟德元年（664年），上(shang)官儀因(yin)替(ti)高宗起草將廢武則天(tian)的詔書，與(yu)父親上(shang)官廷芝一起被(bei)武則天(tian)所(suo)殺(sha)，剛剛出(chu)生的上(shang)官婉兒與(yu)母親鄭氏同被(bei)配(pei)沒掖(ye)廷。在掖(ye)廷為奴(nu)期間，在其母的精(jing)心培養下，上(shang)官婉兒熟讀詩書，不(bu)僅能吟詩著文(wen)，而且明達吏事，聰敏異常(chang)。
儀鳳二年（677年），武則(ze)天(tian)召見了年僅十四(si)歲的上(shang)官(guan)婉(wan)兒，當場出(chu)題考較。上(shang)官(guan)婉(wan)兒文不加點(dian)，須臾而成(cheng)，且文意(yi)通暢，詞藻華(hua)麗，語言(yan)優美，真好像是夙構而成(cheng)。武則(ze)天(tian)看后大悅，當即下令免其奴婢(bi)身份，讓其掌(zhang)管宮中詔命。
墓(mu)志(zhi)載其(qi)十三歲為才人，可能是(shi)武則天為了免去(qu)其(qi)奴婢(bi)身(shen)份(fen)而給予(yu)的名份(fen)。
后(hou)來武則(ze)天稱(cheng)帝，詔敕多出其手者，時稱(cheng)“內舍人”。不久，上(shang)官婉(wan)兒又因違忤(wu)旨意(yi)，罪(zui)犯死刑(xing)，但武則(ze)天惜其文才(cai)而(er)特(te)予赦免，只(zhi)是處以黥面而(er)已(yi)。以后(hou)，上(shang)官婉(wan)兒遂精心伺奉，曲意(yi)迎合，更得武則(ze)天歡(huan)心。
從通天元年（696年）（出自《景龍文館(guan)記》，《舊唐(tang)書(shu)》為(wei)圣歷年）開始，又(you)讓(rang)其處理百(bai)司奏表，參決(jue)政務，權勢日(ri)盛(sheng)。
神(shen)(shen)龍元年(nian)(nian)（705年(nian)(nian)），張柬之等擁護李唐宗(zong)室(shi)的大臣(chen)發動神(shen)(shen)龍政變，武則天被(bei)(bei)迫退位。神(shen)(shen)龍政變后，唐中宗(zong)復辟(pi)，又令上官(guan)婉兒專掌起草詔令，深被(bei)(bei)信任，又拜為(wei)昭(zhao)容，封其母(mu)鄭(zheng)氏為(wei)沛國夫人。
上(shang)官婉兒與韋皇后(hou)、安樂公(gong)主亦(yi)多往來，屢次勸說韋皇后(hou)行武則天的(de)故事，于是韋皇后(hou)上(shang)表請求規定(ding)(ding)全國士民百(bai)姓一律為被父親休棄(qi)的(de)母親服喪三年。又請求規定(ding)(ding)天下(xia)百(bai)姓二十三歲時才算成丁，到(dao)五(wu)十九年就免除勞役，改(gai)易制度，用(yong)來收取(qu)人心民望，李顯都準(zhun)許了(le)。
上(shang)官(guan)婉兒(er)又向韋(wei)皇后推薦武(wu)三思，將武(wu)三思領進宮(gong)中(zhong)，李(li)顯于是開(kai)始與武(wu)三思商議政事(shi)，張柬之(zhi)等(deng)(deng)人從此(ci)都受到了武(wu)三思的遏制(zhi)。不(bu)久，武(wu)三思依靠(kao)韋(wei)皇后和(he)安樂公主等(deng)(deng)人的支持，相繼設計貶殺了張柬之(zhi)、桓(huan)彥范、敬暉(hui)、袁恕己(ji)和(he)崔玄暐等(deng)(deng)五王(wang)，權(quan)傾人主，不(bu)可一世。上(shang)官(guan)婉兒(er)又與其(qi)私通，并在(zai)所草詔令中(zhong)，經常推崇武(wu)氏而排抑皇家，致使太子(zi)李(li)重俊(jun)氣憤(fen)不(bu)已。
景龍元年（707年）七月(yue)，李(li)重(zhong)俊與左羽(yu)(yu)(yu)林(lin)(lin)大將(jiang)軍(jun)(jun)李(li)多祚等，矯(jiao)詔發羽(yu)(yu)(yu)林(lin)(lin)軍(jun)(jun)三(san)百(bai)余(yu)(yu)人(ren)，殺(sha)武三(san)思、武崇訓于其府第，并誅其親黨十余(yu)(yu)人(ren)，又(you)引兵(bing)(bing)從肅章門(men)斬(zhan)關而(er)入，叩(kou)擊閣門(men)而(er)搜捕上(shang)官婉(wan)(wan)兒。上(shang)官婉(wan)(wan)兒急忙逃至唐中(zhong)宗和(he)韋(wei)皇后處，并揚言(yan)說：“觀太(tai)子之意，是先殺(sha)上(shang)官婉(wan)(wan)兒，然(ran)后再依次捕弒皇后和(he)陛下。”李(li)顯和(he)韋(wei)皇后一時大怒，遂帶著上(shang)官婉(wan)(wan)兒和(he)安(an)樂公主(zhu)登上(shang)玄武門(men)躲避兵(bing)(bing)鋒，令右羽(yu)(yu)(yu)林(lin)(lin)將(jiang)軍(jun)(jun)劉(liu)仁景率飛騎二千余(yu)(yu)人(ren)，屯(tun)太(tai)極殿(dian)前，閉門(men)自守。李(li)重(zhong)俊兵(bing)(bing)敗被殺(sha)。
但據(ju)墓志記載(zai)，上官婉兒曾四次向中(zhong)宗(zong)進(jin)諫(jian)，反對(dui)立安樂(le)公主為(wei)皇太(tai)女，從檢(jian)舉揭發，到(dao)辭官不做，再(zai)到(dao)削發為(wei)尼，都沒有得(de)到(dao)唐中(zhong)宗(zong)準許，最(zui)終以(yi)死(si)相(xiang)諫(jian)。喝毒(du)藥(yao)后，太(tai)醫緊(jin)急(ji)救治，才得(de)以(yi)保命。
上(shang)(shang)官(guan)婉兒深得李顯、韋皇(huang)后信任(ren)，專秉內政，祖父一案也被平反，上(shang)(shang)官(guan)儀追贈(zeng)中(zhong)書令、秦州(zhou)都督、楚國公，上(shang)(shang)官(guan)庭芝追贈(zeng)黃(huang)門侍郎、岐州(zhou)刺(ci)史(shi)、天水郡公。
此后，上(shang)官婉(wan)兒又經常勸說李(li)顯(xian)，大(da)量設置昭文(wen)館學士，廣(guang)召(zhao)當朝(chao)詞學之臣(chen)，多次(ci)賜宴游樂，賦詩唱和。每次(ci)都同時(shi)代替李(li)顯(xian)和韋皇后和安(an)樂公主，數(shu)首并(bing)作(zuo)(zuo)，詩句優(you)美，時(shi)人大(da)多傳誦唱和。對大(da)臣(chen)所(suo)作(zuo)(zuo)之詩，李(li)顯(xian)又令(ling)她(ta)進行評定，名列第一者，常賞(shang)賜金爵，貴重無(wu)(wu)比。因此，朝(chao)廷(ting)內(nei)外，吟詩作(zuo)(zuo)賦，靡然成(cheng)風。上(shang)官婉(wan)兒酷愛藏(zang)書(shu)，曾藏(zang)書(shu)萬余卷(juan)，所(suo)藏(zang)之書(shu)均(jun)以香薰之。百年之后，其書(shu)流(liu)落民間(jian)，依然芳香撲(pu)鼻(bi)且無(wu)(wu)蟲蛀。
其母(mu)鄭氏去世后追謚為節義夫人，婉兒(er)上表(biao)將自己的品級降為婕妤(yu)以示哀悼，不久(jiu)之后恢復。
李(li)顯(xian)派(pai)人又在(zai)上官婉(wan)兒(er)(er)居(ju)地(di)穿池筑(zhu)巖，窮極(ji)雕飾，常(chang)引大臣宴(yan)樂(le)其(qi)中。當時(shi)，宮禁寬疏，允(yun)許宮內官員任(ren)意出入。上官婉(wan)兒(er)(er)遂(sui)與(yu)一些宮官在(zai)宮外購筑(zhu)宅第(di)，經常(chang)與(yu)他們交接往(wang)來，有的人因(yin)(yin)此而求得高官要職(zhi)。中書侍郎(lang)崔湜就是因(yin)(yin)為與(yu)上官婉(wan)兒(er)(er)在(zai)外宅私(si)通，后被引以(yi)為相的。不久，崔湜又在(zai)主持銓(quan)選(xuan)時(shi)，多有違失，被御史(shi)李(li)尚(shang)隱彈劾，以(yi)罪被貶外州司馬(ma)；也因(yin)(yin)上官婉(wan)兒(er)(er)和(he)安(an)樂(le)公主為其(qi)申理，仍官復原職(zhi)。
景龍四年(nian)（710年(nian)），太(tai)平公主(zhu)勢(shi)力日盛，上(shang)官婉兒又依附(fu)太(tai)平公主(zhu)。六月，李(li)顯突(tu)然駕崩(beng)，韋(wei)(wei)(wei)皇后將臺閣政(zheng)職(zhi)、內外兵(bing)馬(ma)大權以(yi)(yi)及中央禁軍等全部安排(pai)了(le)自己的黨羽和族人，朝政(zheng)大權盡落韋(wei)(wei)(wei)氏之手。上(shang)官婉兒與太(tai)平公主(zhu)起草了(le)一份遺詔，立李(li)重茂為皇太(tai)子，李(li)旦(dan)輔政(zheng)，韋(wei)(wei)(wei)皇后為皇太(tai)后攝政(zheng)，以(yi)(yi)平衡(heng)各方勢(shi)力，然而宰相宗楚客、韋(wei)(wei)(wei)溫更改詔書(shu)，勸(quan)韋(wei)(wei)(wei)后效(xiao)仿武則(ze)天。
得(de)到消息的臨淄王(wang)李(li)隆(long)基(ji)與太(tai)平公(gong)(gong)主商議，決(jue)定先下手為強，7月21日李(li)隆(long)基(ji)發動唐隆(long)之變，以禁軍官(guan)兵(bing)攻入(ru)宮中，殺死(si)韋(wei)后(hou)、安樂(le)公(gong)(gong)主及所有(you)韋(wei)后(hou)一黨(dang)，擁立其父李(li)旦。上官(guan)婉兒(er)執(zhi)燭率宮人(ren)迎接，并(bing)把她(ta)與太(tai)平公(gong)(gong)主所擬遺(yi)詔(zhao)拿給劉幽求觀看，以證明自己是(shi)和(he)李(li)唐宗室(shi)站(zhan)在一起(qi)的，劉幽求拿著(zhu)遺(yi)詔(zhao)求李(li)隆(long)基(ji)開恩，但李(li)隆(long)基(ji)不許，殺上官(guan)婉兒(er)于(yu)(yu)旗(qi)下。后(hou)葬于(yu)(yu)雍州咸陽縣茂道鄉(xiang)洪(hong)瀆原，太(tai)平公(gong)(gong)主非常哀傷(shang)，派人(ren)去(qu)吊祭，并(bing)出錢五百匹絹。
景云(yun)二年（711年）七月(yue)，復封為昭容，謚號惠文。但據(ju)2013年9月(yue)出土(tu)的墓(mu)(mu)志銘可(ke)以確定(ding)上(shang)(shang)官婉(wan)兒是被(bei)葬(zang)于唐(tang)景云(yun)元年八月(yue)，其墓(mu)(mu)志蓋上(shang)(shang)已刻上(shang)(shang)了(le)(le)“大唐(tang)故昭容上(shang)(shang)官氏銘”，即(ji)可(ke)確定(ding)在上(shang)(shang)官婉(wan)兒死(si)后不久，也即(ji)被(bei)葬(zang)的時候(hou)就已經(jing)恢復了(le)(le)其昭容的稱號而不是史書上(shang)(shang)記載的死(si)去一(yi)年后的景云(yun)二年七月(yue)。
開元初年，李隆基(ji)派人將上(shang)官婉兒的詩(shi)(shi)作(zuo)收集(ji)起(qi)來，編成文(wen)(wen)集(ji)二(er)十卷，令張說(shuo)作(zuo)序(xu)。但據張說(shuo)所著《唐昭容(rong)上(shang)官氏文(wen)(wen)集(ji)序(xu)》，結合墓(mu)志內容(rong)推測，應(ying)該(gai)是太平公主(zhu)上(shang)表請(qing)求編集(ji)文(wen)(wen)集(ji)。此集(ji)今佚，《全唐詩(shi)(shi)》僅收其遺詩(shi)(shi)三(san)十二(er)首(shou)。
