{"id":639,"date":"2026-04-11T21:44:25","date_gmt":"2026-04-11T21:44:25","guid":{"rendered":"http:\/\/localhost:8088\/articles\/using-variables\/"},"modified":"2026-06-01T09:17:22","modified_gmt":"2026-06-01T09:17:22","slug":"using-variables","status":"publish","type":"knowledge_article","link":"https:\/\/help.upwex.io\/en\/articles\/using-variables\/","title":{"rendered":"Using Variables (placeholders)"},"content":{"rendered":"<p>Variables turn a generic prompt into a personalized proposal. Wrap a name in <code>[square brackets]<\/code> inside your template and AI replaces it with a real value at generation time. The Template Editor sidebar groups all built-in variables into four categories \u2013 click any chip to insert it at the cursor, or just type the brackets manually.<\/p>\n<p><img decoding=\"async\" src=\"\/wp-content\/uploads\/help\/ss-cl-04-variables-sidebar.png\" alt=\"Template Editor with variables sidebar \u2013 TEMPLATE DATA (Portfolio, Signature), FREELANCER (Freelancer Name, Hourly Rate, Skills, Freelancer Country, Freelancer City, Freelancer Timezone), CLIENT (Client Name, Client Country, Client City, Client Greeting, Client Pain Point), PROPOSAL (Opening Question, Problem Mirror, Proof Point, Micro First Step, Availability Match, Budget Rate Fit, Budget Ack, Requirement Ack, Timezone Overlap, CTA); right area shows a sample template with green-highlighted variables and a Test Template button at the bottom\" \/><\/p>\n<h2>TEMPLATE DATA \u2013 your reusable values<\/h2>\n<p>Stored once on the Cover Letters page under the TEMPLATE DATA section. Use them in any template:<\/p>\n<ul>\n<li><code>[Portfolio]<\/code> \u2013 your portfolio links (or whatever value you saved under the Portfolio entry)<\/li>\n<li><code>[Signature]<\/code> \u2013 your signature block \u2013 name, role, contact, links<\/li>\n<\/ul>\n<p>You can add your own entries on the Cover Letters page (rates, contact details, etc.) and they&#8217;ll show up here as new chips automatically.<\/p>\n<h2>FREELANCER \u2013 pulled from your synced Upwork profile<\/h2>\n<ul>\n<li><code>[Freelancer Name]<\/code> \u2013 your Upwork display name<\/li>\n<li><code>[Hourly Rate]<\/code> \u2013 your set hourly rate<\/li>\n<li><code>[Skills]<\/code> \u2013 your top skills<\/li>\n<li><code>[Freelancer Country]<\/code> \u2013 your country<\/li>\n<li><code>[Freelancer City]<\/code> \u2013 your city<\/li>\n<li><code>[Freelancer Timezone]<\/code> \u2013 your timezone<\/li>\n<\/ul>\n<p>Make sure your Upwork profile is synced (see <em>Sync your Upwork profile<\/em>) so these values are up to date.<\/p>\n<h2>CLIENT \u2013 extracted from the job and the client&#8217;s profile<\/h2>\n<ul>\n<li><code>[Client Name]<\/code> \u2013 the client&#8217;s first name if visible on the job page (falls back to &#8220;there&#8221; or &#8220;team&#8221;)<\/li>\n<li><code>[Client Country]<\/code> \u2013 the client&#8217;s country from the job posting<\/li>\n<li><code>[Client City]<\/code> \u2013 the client&#8217;s city, if available<\/li>\n<li><code>[Client Greeting]<\/code> \u2013 a context-appropriate greeting (&#8220;Hi&#8221;, &#8220;Hello&#8221;, &#8220;Good morning&#8221;) based on tone and timezone<\/li>\n<li><code>[Client Pain Point]<\/code> \u2013 the specific problem AI infers from the job description<\/li>\n<\/ul>\n<h2>PROPOSAL \u2013 AI-generated for the specific job<\/h2>\n<p>These are produced fresh for each job at submission time, so the proposal stays unique:<\/p>\n<ul>\n<li><code>[Opening Question]<\/code> \u2013 an engaging, non-generic question to start the proposal<\/li>\n<li><code>[Problem Mirror]<\/code> \u2013 restates the client&#8217;s problem in your own words to show you understood it<\/li>\n<li><code>[Proof Point]<\/code> \u2013 a concrete past achievement relevant to this job<\/li>\n<li><code>[Micro First Step]<\/code> \u2013 a small, specific first action you&#8217;d take if hired<\/li>\n<li><code>[Availability Match]<\/code> \u2013 confirms you can start within the client&#8217;s timeline<\/li>\n<li><code>[Budget Rate Fit]<\/code> \u2013 addresses budget compatibility tactfully<\/li>\n<li><code>[Budget Ack]<\/code> \u2013 acknowledges the budget without negotiating<\/li>\n<li><code>[Requirement Ack]<\/code> \u2013 confirms you understand the listed requirements<\/li>\n<li><code>[Timezone Overlap]<\/code> \u2013 describes the working-hours overlap with the client<\/li>\n<li><code>[CTA]<\/code> \u2013 a closing call to action \u2013 question or invitation to chat<\/li>\n<\/ul>\n<h2>Custom brackets<\/h2>\n<p>You&#8217;re not limited to the built-in chips. Anything you put in <code>[brackets]<\/code> works as long as AI can infer it from context \u2013 e.g. <code>[My Qualifications]<\/code>, <code>[Engaging Question]<\/code>, <code>[React Years]<\/code>. AI also accepts both spaced and PascalCase forms \u2013 <code>[Problem Mirror]<\/code> and <code>[ProblemMirror]<\/code> are treated the same way.<\/p>\n<h2>How variables get filled in<\/h2>\n<p>When you click <strong>Generate<\/strong> in the widget on Upwork, AI:<\/p>\n<ol>\n<li>Reads the template and identifies all bracket tokens<\/li>\n<li>Pulls TEMPLATE DATA and FREELANCER values from your account \/ synced profile<\/li>\n<li>Extracts CLIENT values from the current job page and client profile<\/li>\n<li>Generates PROPOSAL values fresh for this specific job<\/li>\n<li>Resolves any custom brackets from the job context<\/li>\n<li>Blends everything into the final cover letter<\/li>\n<\/ol>\n<h2>Tips<\/h2>\n<ul>\n<li><strong>3\u20135 variables per template<\/strong> is the sweet spot \u2013 more than ~8 starts to feel stilted.<\/li>\n<li><strong>Use each variable once.<\/strong> Repeating <code>[Freelancer Name]<\/code> three times reads like a broken mail merge.<\/li>\n<li><strong>Mix static and dynamic text.<\/strong> A few hardcoded phrases plus a handful of variables sounds the most natural.<\/li>\n<li><strong>Test before saving.<\/strong> Use the <strong>\u25b6 Test Template<\/strong> button to preview how variables resolve before you ship the template.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Full list of Upwex template variables \u2013 TEMPLATE DATA, FREELANCER, CLIENT, PROPOSAL \u2013 and what each one resolves to.<\/p>\n","protected":false},"featured_media":0,"template":"","class_list":["post-639","knowledge_article","type-knowledge_article","status-publish","hentry","knowledge_category-cover-letter-templates"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.6 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Using Variables (placeholders) | Upwex Customer Service &amp; Support | Upwex Help<\/title>\n<meta name=\"description\" content=\"Explore comprehensive guides, FAQs, and step-by-step tutorials for Upwex. Start improving your Upwex experience today!\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/help.upwex.io\/en\/articles\/using-variables\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Using Variables (placeholders) | Upwex Customer Service &amp; Support | Upwex Help\" \/>\n<meta property=\"og:description\" content=\"Explore comprehensive guides, FAQs, and step-by-step tutorials for Upwex. Start improving your Upwex experience today!\" \/>\n<meta property=\"og:url\" content=\"https:\/\/help.upwex.io\/en\/articles\/using-variables\/\" \/>\n<meta property=\"og:site_name\" content=\"Upwex Customer Service &amp; Support | Upwex Help\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-01T09:17:22+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/help.upwex.io\/wp-content\/uploads\/2024\/09\/upwex-preview.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1078\" \/>\n\t<meta property=\"og:image:height\" content=\"605\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/help.upwex.io\/en\/articles\/using-variables\/\",\"url\":\"https:\/\/help.upwex.io\/en\/articles\/using-variables\/\",\"name\":\"Using Variables (placeholders) | Upwex Customer Service &amp; Support | Upwex Help\",\"isPartOf\":{\"@id\":\"http:\/\/localhost:8088\/en\/#website\"},\"datePublished\":\"2026-04-11T21:44:25+00:00\",\"dateModified\":\"2026-06-01T09:17:22+00:00\",\"description\":\"Explore comprehensive guides, FAQs, and step-by-step tutorials for Upwex. Start improving your Upwex experience today!\",\"breadcrumb\":{\"@id\":\"https:\/\/help.upwex.io\/en\/articles\/using-variables\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/help.upwex.io\/en\/articles\/using-variables\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/help.upwex.io\/en\/articles\/using-variables\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"http:\/\/localhost:8088\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"\u0421\u0442\u0430\u0442\u044c\u0438\",\"item\":\"https:\/\/help.upwex.io\/en\/articles\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Using Variables (placeholders)\"}]},{\"@type\":\"WebSite\",\"@id\":\"http:\/\/localhost:8088\/en\/#website\",\"url\":\"http:\/\/localhost:8088\/en\/\",\"name\":\"Upwex Customer Service &amp; Support | Upwex Help\",\"description\":\"Get the Help You Need to Use Upwex\",\"publisher\":{\"@id\":\"http:\/\/localhost:8088\/en\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"http:\/\/localhost:8088\/en\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"http:\/\/localhost:8088\/en\/#organization\",\"name\":\"Upwex.io\",\"url\":\"http:\/\/localhost:8088\/en\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"http:\/\/localhost:8088\/en\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/help.upwex.io\/wp-content\/uploads\/2024\/09\/upwex-logo24.png\",\"contentUrl\":\"https:\/\/help.upwex.io\/wp-content\/uploads\/2024\/09\/upwex-logo24.png\",\"width\":1669,\"height\":324,\"caption\":\"Upwex.io\"},\"image\":{\"@id\":\"http:\/\/localhost:8088\/en\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Using Variables (placeholders) | Upwex Customer Service &amp; Support | Upwex Help","description":"Explore comprehensive guides, FAQs, and step-by-step tutorials for Upwex. Start improving your Upwex experience today!","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/help.upwex.io\/en\/articles\/using-variables\/","og_locale":"en_US","og_type":"article","og_title":"Using Variables (placeholders) | Upwex Customer Service &amp; Support | Upwex Help","og_description":"Explore comprehensive guides, FAQs, and step-by-step tutorials for Upwex. Start improving your Upwex experience today!","og_url":"https:\/\/help.upwex.io\/en\/articles\/using-variables\/","og_site_name":"Upwex Customer Service &amp; Support | Upwex Help","article_modified_time":"2026-06-01T09:17:22+00:00","og_image":[{"width":1078,"height":605,"url":"https:\/\/help.upwex.io\/wp-content\/uploads\/2024\/09\/upwex-preview.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/help.upwex.io\/en\/articles\/using-variables\/","url":"https:\/\/help.upwex.io\/en\/articles\/using-variables\/","name":"Using Variables (placeholders) | Upwex Customer Service &amp; Support | Upwex Help","isPartOf":{"@id":"http:\/\/localhost:8088\/en\/#website"},"datePublished":"2026-04-11T21:44:25+00:00","dateModified":"2026-06-01T09:17:22+00:00","description":"Explore comprehensive guides, FAQs, and step-by-step tutorials for Upwex. Start improving your Upwex experience today!","breadcrumb":{"@id":"https:\/\/help.upwex.io\/en\/articles\/using-variables\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/help.upwex.io\/en\/articles\/using-variables\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/help.upwex.io\/en\/articles\/using-variables\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"http:\/\/localhost:8088\/en\/"},{"@type":"ListItem","position":2,"name":"\u0421\u0442\u0430\u0442\u044c\u0438","item":"https:\/\/help.upwex.io\/en\/articles\/"},{"@type":"ListItem","position":3,"name":"Using Variables (placeholders)"}]},{"@type":"WebSite","@id":"http:\/\/localhost:8088\/en\/#website","url":"http:\/\/localhost:8088\/en\/","name":"Upwex Customer Service &amp; Support | Upwex Help","description":"Get the Help You Need to Use Upwex","publisher":{"@id":"http:\/\/localhost:8088\/en\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"http:\/\/localhost:8088\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"http:\/\/localhost:8088\/en\/#organization","name":"Upwex.io","url":"http:\/\/localhost:8088\/en\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"http:\/\/localhost:8088\/en\/#\/schema\/logo\/image\/","url":"https:\/\/help.upwex.io\/wp-content\/uploads\/2024\/09\/upwex-logo24.png","contentUrl":"https:\/\/help.upwex.io\/wp-content\/uploads\/2024\/09\/upwex-logo24.png","width":1669,"height":324,"caption":"Upwex.io"},"image":{"@id":"http:\/\/localhost:8088\/en\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/help.upwex.io\/en\/wp-json\/wp\/v2\/knowledge_article\/639","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.upwex.io\/en\/wp-json\/wp\/v2\/knowledge_article"}],"about":[{"href":"https:\/\/help.upwex.io\/en\/wp-json\/wp\/v2\/types\/knowledge_article"}],"wp:attachment":[{"href":"https:\/\/help.upwex.io\/en\/wp-json\/wp\/v2\/media?parent=639"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}