Introducing Hypertext: “@” links for Projects, Tasks, People, and Tags

Asana is building a new way for groups to communicate and coordinate. We have designed our app to combine the flexibility of a piece of paper with the structure and intelligence of a digital brain. In support of this goal, Asana already offers multiple ways to connect items in a Workspace: Tasks can simultaneously live in multiple Projects, have multiple people as followers, and be connected across Projects by Tags.

But there are often more subtle relationships between Tasks, Projects, and People. We wanted a way to capture these nuanced relationships and make the process of establishing them happen at the speed of thought.

Introducing Hypertext

Hypertext is a new Asana feature that makes it lightning fast to create links between any two things in a Workspace. Just type “@” into any note or comment, and instantly search for Tasks, Projects, People, or Tags. Select the item you want, and Asana inserts a link to that item into the note or comment. While you’re commenting on a task, @-mention a teammate, and they’ll be automatically added as a follower and receive your comment.

Hypertext makes adding context easy, fluid, and flexible, enabling you to link to Tasks, Projects, People, and Tags nearly as fast as you can type. With Hypertext, you don’t have to forward long email threads to give your teammates the context they need. You don’t have to copy and paste URLs from one Task to another. You just type “@” and link. Hypertext gives you a new way to connect information inside Asana and lets you navigate these connections with a single click.

When will I use Hypertext?

Hypertext increases both the flexibility and the structure of Asana. There are dozens of ways you might use it. Here are just a few:

Linking to Tasks

Linking from one Task another is a great way to highlight related Tasks, point out dependencies, close out duplicates and link follow-up Tasks back to richer sources of information. You could, for example, capture a customer interview in the notes of one Task and link future tasks back to the that interview. You could link a feature you’re working on back to the customer request that inspired it. You could link a task to publish a blog post announcing a feature to the task to launch the feature, as seen here:

Linking to Projects

Linking from a Task to a Project is a great way to connect a high-level task to the Project that contains the execution details. This is great for sprint planning. You can also link Tasks to Projects to highlight dependencies between them.

Linking to People

Linking to a Person from a comment is the fastest way to bring him or her into the loop. You can also use links to People to direct comments:

Hypertext’s Future

The introduction of Hypertext is just the beginning. In the future, you’ll be able to view all of the Tasks that link to the current Task, enabling you to see dependencies, duplicates, and related Tasks at a glance. Hypertext will enable your team to represent and navigate the relationships between Tasks, Projects, People, and ideas in ways that haven’t been possible before. Ultimately, you’ll achieve your goals more quickly, and be even more empowered to do great things.

Would you recommend this article? Yes / No
  • Clay
    Thank you for this! Now I can keep my internal links within a single browser window, and it’s easy to spoof subtasks while waiting for a more integrated solution.

    Cheers! :)

  • Dave Mackey
    Nice. Keep up the good work, and read my suggests on Dave Enjoys. ;)
  • Matt
    Hey guys, great new feature. Just thought I’d point out here that the RSS feed doesn’t have a name/title. When I added the feed to Reeder for Mac, it pulls in the feed fine but does not display the name of the feed, i.e. Asana Blog
  • Ash Menon
    I love that you guys are continuously thinking “How can we make this even better.” It’s really inspiring to see such a project blossom, especially since I was here since the beta period.
  • OQ
    Very nice feature. Can’t wait to see how it works at a ‘glance’
  • opher
    Awesome! How about using current task number to link to that task? IE @123 translates to the current task numbered 123 (and still maintain this link even if the number changes). That would be much faster than searching by name
  • Mohammed
    Is this currently live already for all or will be rolled out? As it doesn’t seem to work for me at the moment?

    Also now that this is done, any news on the iPhone Mobile App update, subtasks feature and coloured labels?

  • Kris
    Opher, clever suggestion! We will consider that in the future.

    Mohammed, it should be rolled out for everyone already however you may need to reload your browser to get the latest version of the code. If that doesn’t work, please write to and we’ll help you figure out what’s wrong.

  • Irina I
    This is a game changer feature! Asana is already fast and this will make it even better.
  • Michael
    Wow…This is so much better than having to copy / paste URL’s to link dependencies.
  • Ben
    Love this, thanks guys!
  • Mike
    Wow, it’s like you read my mind or something: just before I saw the strip at the top of the page that called this feature out, I was poking around for a “permalink” to an individual task. I have now found it. Thanks for continuing to innovate!
  • Shannon
    Hypertexting to create traditional links out to external web apps and sites would be useful. Imagine if your team were collaborating on Google docs in a Google drive. It would simplify the sign-in process….. I’d be the first to use it!
  • Peggy
    Thanks for this new feature!
  • Colin
    How do I escape the “@” character? I cannot enter a complete email address now.
  • Eddie
    Very nice feature. Seems like the developers take in feature requests seriously :) Kudos!
  • Brett Warner
    Awesome I Love it!
  • Lauren
    Awesome idea! Can’t wait to start using it!
  • eric
    nice work!
  • Branden Silva
    Great idea and I love it.

    My only recommendation would to be to have it auto complete with a tab. Right now you have to hit “enter” to do this which makes me think of accidentally submitting a comment before I’ve completed it.

    Seeing how tab is used a lot throughout the app, this seems like a good spot for it as well.


    Going out with @Ann (auto completes and @ links Anne Hathaway) tonight to show off Asana! (to submit comment)

  • Branden Silva
    Last comment didn’t accept my key enters.


    Going out with @Ann (Hit tab key. Auto completes and @ links Anne Hathaway) tonight to show off Asana! (Hit enter key. to submit comment)

  • kris
    Shannon, we agree that would be awesome. That’s definitely something we’re considering.
  • kris
    Colin, I’m sorry your having trouble typing emails. The hypertext feature is only supposed to activate if you type an ‘@’ that is not preceded by a space. We did this to make typing emails easier. Could you please let me know which browser your using if that is not the case?

    You can hit escape on your keyboard to exit the hypertext dropdown and keep typing as normal.

  • kris
    Branden, I’ll add a task to look into auto-completing on tab in addition to enter to our Asana project for hypertext.
  • Jan
    It doesn’t work for me. I tried with names an tasks, but nothing happens… I tried Google Chrome and Firefox.
  • Pat Erler
    Nice Idea, but It bothers me a bit, that the @ is removed. Mainly we use @Paul to ask a question in a status update (@Paul: Can you check please?) – without the @ “Paul” is just a link and you don’t know if it is referring to Paul or asking a question.

    But this is minor. Keep up!

  • Fabio
    Great! :)
  • Will
    Nothing happens for me on Chrome not sure if this is rolled out to everyone or just stopped working after a day ( see another comment above me saying not working on the 8th )
  • Marco Matarazzo
    Awesome !!!
  • Niall
    This only seems to work with a US keyboard layout in Windows – ie with it set to EN-US, shift-2 then gives a hint that hyperlinks are available; with the layout set to EN-UK, the @ is shift-‘ (apostrophe) and nothing happens.
    Disappointing that this means faffing about with the language bar and remembering where the @ is on a US keyboard.
  • Halima
    Works like a charm – I just spent a few minutes looking for a task earlier while on a call, now I can link to it for all users to see. Fantastic ! Thanks a lot guys !

    Now, let’s have that multi-ownership feature for tasks and I’ll be as happy as an Asanian can get :)

  • Jonny
    It doesn’t work
  • Tobias
    Doesn’t work for me either (using European keyboard)
  • Janice
    Great work !!
  • Dwain
    Lovely, thank you so much Asana:
  • Christopher
    Excellent feature, but sadly not working for me either. I’m using latest versions of Chrome and Firefox. UK Keyboard layout. Also tried cleared my cache.
  • Marc
    Excellent addition and working fine here on my Swiss German keyboard on the current chrome version.
    What could be enhanced is the turnaround time cause the refreshing of the list or the box showing up at all take a fair amount of time despite this being a Core i7 2011MBP
  • James
    Not working for me either (using European keyboard).
  • Katja
    Sounds exciting and helpful, but isn’t working for me either (UK keyboard)
  • Moore
    Doesn’t work for me either in the UK, after refreshing, logging out and closing down my Chrome browser. Sad face :(
  • Brandon Nolte
    I guess this doesn’t work when trying to link to other work spaces?
  • Brian
    I don’t know if anyone else made this suggestion, but when you click through to a linked task, it would be nice to see in that task if anything linked to it, to get the full context. for example, Task 1 links to Task 3. When I arrive at Task 3, it would be nice to see the inbound link from Task 1 (tasks/objects are “link aware” somehow)
  • Syed Rakib Al Hasan
    Brilliant………. such a feature was very much needed
  • Daniel
    awesome ! thank you…
  • Roderick
    Very kewl!!
  • Ryan Porter
    Love this!!! Great to see Asana getting these bonus feature that make it that much better!

    Suggestion: allow us to delete users last name in an “@” tag.

  • John Salzarulo
    Such a surprising feature. I didn’t even realize how useful this would be.
  • Juan
    Flawless! Thanks and keep it up upgrading!
  • Alex
    Great feature. Right now I place links to a related tasks in comments, where they are converted into clickable task name. Would these links also be included in upcoming feature, that would list all tasks, that reference this one and via-versa?
  • Dale Larsen
    Perfect! Asana really understands and implements what we need. Thanks!
  • Amartya
    Awesome! I’ve been waiting for this feature.
  • Joe
    doesnt work at all on my systems – tried in current Chrome and Firefox
  • Aziz Syed
    Its really helpful. Now I don’t have to copy paste the URL of tasks when referencing.

    Keep up the good work guys!

  • Ramon RAy
  • Ian
    Great feature! lovin it.
  • Ziko
    Fantastic! I’ve been looking forward to something like this. I can set commonalities and dependencies **without depending on a rigid structure**
    Love it.
  • TillmanZ
    Great feature!
    But I do have to report that on a Mac running Chrome 21 with German keyboard it doesn’t (yet) work.
  • Justin
    What @shannon said. And hyperlink to Google mail please!
  • Colin

    Thanks, what I wanted to enter is something like * It enables hyper-text. I tried the Esc key and it works great!

  • Nico
    This sounds like an awesome idea. Can’t wait to try it out. Big thanks to you guys!
  • sk
    Great feature, works superbly
  • kris
    For all of you having issues with non US keyboard layouts, we apologize for the inconvenience. We will look into making this a smoother experience for you as soon as possible.
  • Mike Walsh
    Very clever – its like a reversal of Facebook putting the task rather than the person at the center of the activity universe.
  • Bhupendra
    Nice feature. How about ability to connect with a repository? Link a task to a commit?
  • Licheng
    It seems not support the Chinese input.
  • Matt Hixson
    I really appreciate how you guys have continuously evolved things. You can tell there is a mentality of continuous deployment with little changes and always looking to bring in new features. Thanks
  • hans
    please consider supporting Japanese language :)
  • andreas
    it seems not work on a German keyboard
  • Tom L
    How does this work if you are contributing to a conversation via email? I’m guessing it’s not possible to make these links, which would be a big shame, as in most of my projects 90% of the comments come from email.
  • Felix
    Using German-Keyboard and Chrome latest version…

    Nevertheless thanks for this wonderful tool!!! Keep up that awesome work!
    Thank You!

  • Krzysiek Dróżdż
    Great. It’s exactly what I was waiting for :)
  • Kris
    Tom, if your contributing via email you can still include links to projects, tasks, people, etc and they will be turned into the actually names of the objects when viewed in Asana. In fact, you can also enter asana links inside asana and they will be converted to the name of the object as soon as your cursor moves away.
  • Sverre
    +1 on doesn’t work (Norwegian keyboard)


  • Cristian Pinazo V
    very usefull feature.. great work
  • prabhakar s

    Its already great, but just my 2 cents…

    1. Editable Comments. I believe we can just delete posted comments right.
    2. Rich Text Editor for Comments Box.

    I dont know if I am using it the right way, but we tend to use the comments box for Notes related to the task. And it helps to have a Rich Text Editor.

  • Daniela
    It works on my Norwegian keyboard: both in Firefox and Chrome.
  • Arabind
    Very Useful Feature…
  • Philippe
    Next step if possible, display a completed task differently from others (strike-through, gray, green,italic) just show-off somehow.
    Would be so awesome solution for sub-task-like solution
    • Raj
      I agree. Several members of my team have said that instead of greying out and getting removed from the task group, a strikethrough option ONLY would be welcome ;) Or can this already be done?
  • Raphael Gluck
    If you add a file, say an image to a task, and then have lots of comments back and forth, but you want to reference the image at one stage,
    Wouldnt it be a good idea to allow @image to refernce the uploaded file?
    • Clair Melville-Brown
      I Need this function as a designer I often send files to people so I need to be able to reference a particular one a comment
  • Jay
    Thank you!! Thank you!! Thank you!!
  • James Kockelbergh
    So easy to use, just like the rest of ASANA. Great job.
  • Manuel
    Swiss-French keyboard: does not work (Chrome).
  • JS
    Now get make an android app and this would be THE best. (The HTML5 is nice, but doesn’t cut it…too slow…has to download each item every time.)
  • Habib-Sylvain
    Is a fix for non-US keyboards on the way?
  • madiha
    very helpful feature
  • Sanjeev
    What can I say. Wish you more success. Thanks.
  • Augustine Adjei
    This is an excellent aid for my company. Thanks guys. I love the intellisense speed and intuitiveness.
  • Uma S
    How to restrict the assignee from deleting the tasks assigned to him
  • Jaco
    Awesome stuff, love it.
  • Alex
    Does not work (yet?) for me with current firefox on win7, is it already live?
  • Luis Galetto
    Doesn’t work for me either (using latinoamerican keyboard).
  • Pete
    File sharing . . . I’d LOVE to see this tied in with or dropbox teams so I can share files in Asana tasks with team members.
  • Kolja
    Awesome stuff!
  • Julian
    Awesome. I’d love to have this feature.


  • TillmanZ
    Just saw that you guys pushed another build (had to reload) but wanted to let you know that the new @ feature is still not working with German keyboards.
    I will keep on trying each morning… ;-)
  • Yann
    Not working either on French Keyboard.

    One week to implement arobases, it begins to be really long…

  • Edwin Yip | dev of LIVEditor
    Great! Asana is awesome, I’m now using it to plan and track the development of my soon-in-beta new text editor (, with a Firebug-like UI for tweaking css/html/js in realtime).
  • Future
    Great! But there are two additional things in Asana that have to be connected. I mean comments and files.
  • Matt
    This is useful, but I sure wish you’d fix the problem of a consolidated task list across workspaces. People that work on multiple teams needs this to make the product efficient to manage their work.
    • Kenny Van Zant
      Definitely something we’re working on!
  • Stéphane V
    Didn’t work for me… I cleared the cache but I don’t have anything when I hit the @ and then some letters…

    What should be done to get this functionnality ?

    ps : another great functionnality should be to set a percentage of completeness f the task with the keyboard such as typing @50% , or @+10% ;-)

    • Stéphane V
      I read in the comments that they may be some troubles with french keyboards… it is my case, also… so perhaps is the @ not correctly detected ??
      • Kenny
        We are working on a solution for european keyboards now. Sorry for the wait!
        • Mohammed
’s workaround is working fine

          “I’ve found a workaround that could/should work for every european layout (tested under windows/italian layout): type the ‘@’ sign then press alt-2″

          i can confirm that this works using a UK layout : )

        • Bogdan
          Hyperlinks by @ still does not work on Mac with Italian keyboard
  • Yanto Setiawan
    Great Feature !

    Keep up the good work.


  • Christian Perry
    Once again, a lovely feature that makes a post-email reality closer by the day. This is a wonderfully flexible and powerful addition to Asana. Keep it up!
  • Patrick
    Not working for me in Germany either….
  • Derrick
    very awesome new feature. One suggestion for a small improvement: being able to link to task or project attachments within the comments “Hey Kris, check out this document here @LinkToFile.” That’d be extra awesome
  • Pierre Emmanuel
    Hello guys,

    I’m trying to convice my organisation to switch to Asana as soon as possible, it’s a great tool so far!

    As others did before, i’ll point out just 2 issues :
    – the links doesnt work on french keyboards (but i just read you’re working on it, thanks!)
    – As I followed your (very interesting) CRM tutorial, i would definitely need to link my CRM database/workspace (1 project/people) to the tasks workspace. That would just save us an incredible amount of time.

    When do you think those features would be available? So i know if i have to find another solution for now, or should i wait a little bit ?

  • Mohammed
    Ok this STILL does not work in the UK using a UK keyboard layout, if I mash a bunch of “” @@ “@ randomly it does appear bu in a none functional kind of way
    I’ve found a workaround that could/should work for every european layout (tested under windows/italian layout): type the ‘@’ sign then press alt-2. The hypertext searcher should now appear.
    • Luka
      Yes! It works!
      Great workaround – thanks fubles :)
    • Mohammed
      Awesome, can confirm that this also works on a UK Mac keyboard (running Windows) as well! Thanks for sharing!
  • Jim
    I would suggest you use the ~ (tilde) charachter to trigger this feature rather than the @ charachter. The @charachter is in many email addresses and is also used commonly for things like 10.5 gallons @ 3.59 a gallon.

    This would make this awesome new feature even more awesomer.

    Thanks so much for this site you all “get” it

  • andreas
    Thanks fubles! it works fine.on a german keyboard.
    This is a great tool.
  • frank
    thanks to fubles, too! better than switching to us and back again.
    but still too much typing to get a working link. shouldn’t be that difficult to implement that, is it?!?
  • Mvif
    bahut sahi…Neeta ji ekdam sahi baat kahi… aur ekdam sahi mudda uthaya… ajaakal is net ke chakkar mei to pata nahi sabhi ko kya ho gaya hai…n specially females ka to aise logon se yunhi pala padta rahta hai…
  • timm
    Does not work for me SRWIron (Chrome) browser, German keyboard. No completion comes up.
    • Jörg Spieler
      Yes, doesn’t work with chrome or Firefox on Mac!
  • Paolo Bain
    It is clear that it does not work with non-US keyboards. When will solve?
  • Tillman Zschucke
    Still nothing with Chrome 21 (Mac) and a German keyboard.
    Any indication when this will work for us “non-US” keyboard users?
  • Tony West
    This is an interesting extension and reminiscent of Lotus Agenda (vintage groupware). Agenda had the concept of “Views” where every item which was tagged with designated keywords appeared. The powerful thing was that, if you changed the designated keywords, Agenda would “re-scan” the entire object space to rebuild all the views. This meant that you didn’t have to know all the possible tags you might one day want to use in advance. I’d be happy to talk to you about this if you like…
  • Kris Rasmussen
    Hypertext should now work when you type the “@” symbol on all keyboard layouts. Please let us know if you continue to have any issues!

    There are some keyboard layouts that do not have the “@” symbol. For those, you will need to switch to a layout that does have the symbol and then switch back.

  • Vicky
    is the lunascript open source ??
    available for others ?
  • Fabrizio Regini
    It’s not working for me on an Italian keyboard :\, that’s an awesome feature I want it!
  • Aaron Gibralter
    Are the links in comments supposed to remain as actually links. I always find that after picking a person, the link disappears and the text becomes normal, unclickable text.
    • Aaron Gibralter
      Ah, it seems to work in Safari 6, but not Chrome 24 on OS 10.7.5.
  • Erin
    Still not working in Chrome. Using a US keyboard on a MacBook. Won’t work! Help?
  • Marco
    “@” Hypertext still doesn’t work on Italian Keyboard
  • sergio
    not working for me, chrome/ubuntu on italian keyboard. :<
  • sergio
  • Dave Benton
    Grateful I found this feature but one thing that would help tremendously is if I could see the linked child tasks from the parent not just the child to the parent. Any chance you’re working on this and/or have a timeline for implementation?
  • Wodjee
    Can you add Hypertext links in Subtasks with @ ? I cannot do it.
  • ivlivs
    Does not work for me when typing a task title. Is this intended?
    • Sara Himeles
      Are you typing @ + the task name? Please contact us at if necessary.
      • Jan Hubka
        As was mentioned in text above by
        “I’ve found a workaround that could/should work for every European layout (tested under windows/Italian layout): type the ‘@’ sign then press alt-2. The hypertext searcher should now appear.”

        All you have to do is enter @ sign by short cut CTRL + ALT + V or ALT + 64. Once the symbol will appear, simply press ALT + 2 (You must press number 2 not form numeric keyboard but form numbers above the letters).
        AND THAT’S IT!

      • Federico Calore
        If you are using a Mac instead, you can use a very similar workaround: after you’ve typed the @, press ctrl+2, and the search filter will appear.
        Tested on a MacBook + italian keyboard layout.

        @Asana, it would be nice if this would work on not-US keyboards without the need of this clumsy workaround, though.
        Or at least, edit the post and add the heads up; I spent some time before figuring out why it was not working…

  • Tim T-L
    Great feature!
    I would love to be able to use hypertext in subtasks in addition to notes and comments. Same with hyperlinks to external URLs in subtasks.
  • Andrea Moretti
    it still does not work on Italian layout, neither pressing @ and ALT+2
    with USA layout it works well, but is annoying having to switch.
    • Andrea Moretti
      EDIT: on mac it works with CTRL+2 as stated by @Federico Calore
      • Anna
        On my mac with the italian keyboard on it doesn’t work… as most of other Asana shortcuts.
  • charles
    why does this work only in comments?
  • Ben
    Hi !

    First of, great job on Asana !

    Would it be possible to mention attachments ?
    Like there’s a bunch of comments to a task, people attach random pictures as they discuss and I want to mention a specific picture/attachment from the project related to my comment.

    That would be pretty amazing…

    Thanks !

  • danit
    I agree, it would be VERY useful to @mention attachments.
    Currently, to reference an attachment in a different task the experience is:
    – In a task, we have to @mention a task and then tell people which attachment they should manually look for inside that task, and then they must come back to the original task.
    It would be great if instead of that we could just:
    – In a task, @mention any attachment
  • Darjan Zlobec
    Super feature, but my asana has some strange behaviour :( I have ubuntu 12.04/firefox 27 and I have to press Alt Gr + V to get the @ sign and hypertext works, but it automatically makes the @ sign at the beginning of the field… not at the end of text where I press the keys… strange?!?
  • Edgar Leal
    Hypertext is not working
    Google Chrome Versión 39.0.2171.95 m, Laptop Windows 8.1
    • Edgar Leal
      Just got it.

      Problem: enter @ with alt+64
      Solution: enter @ with ctrl+alt+q

      Since I use several computers, some not mine, keyboard configuration is always an issue. Therefore, I always usealt+64.

      It would be great if alt+64 could do the trick as well.

      • Daniele Pansolini
        Hi everyone.
        Good news! I found the solution for all those who it doesn’t work hypertext WITH “@” and use italian keyboard on mac.

        THUS. Write “@” and then press together “ctrl” plus a letter (whatever: c, v, ETC…). After this, it will appear a small white board that says you can add person’s name, tags, tasks,…. and so on.

        start to write normally the name of the person that you want to mention. That’s it!!!

        • YuNYuN
          Grazie, stavo impazzendo!
          Thanks, was going crazy!
  • Giorgio
    Still not working for Italian keyboards.

    Are you going to fix it ?

  • Paulo Silva
    It would be awesome to be able to mention @all people in a task.
  • Sathish
    The reference to link people with @ is a great feature. But when I query for the story through REST API, it returns the link and has no mention of the person’s name and I am unable to derive the directed persons name out of the link. Is there a way around?
  • Bruno Amorim
    Not working for me too. Portuguese keyboard.
  • Bruno Amorim
    Not work for me too. Portuguese Keyboard on Mac OSX 10.10.3 with Google Chrome 43.
  • Douglas Blumeyer
    I’m very excited by the Hypertext’s Future in which I can find all tasks that link to a given task. Any update on how near that future is?