☆☑ Announcing Tag Support


API Support for Tags was a heavily requested feature the OneNote REST API UserVoice community. Today we're happy to announce that the API now supports creating and reading all of OneNote's built in tags, including ☑checkboxes, ☆stars, highlights, and more.

Tags can be added to an element by adding a data-tag attribute. You can check out the full list of supported tags in this gist or jump right into creating your own with some of the samples below.

Simple To-Do List

<li data-tag='to-do:completed'>Write Tag Support Blog Post</li>
<li data-tag='to-do'>Publish Tag Support Blog Post</li>

Important Item

<p data-tag='important'>Remember to mention submitting UserVoice feedback</p>

When you retrieve the content of a page, you'll find your data-tag attribute right where you left it.

That's all there is to it. Now get tagging!

-Nick, on behalf of the OneNote API Team

Comments (6)

  1. Pooja Dhannawat says:

    In output html I can just see the name of the tag. How can I access the icon associated with the tag or some metadata related to tag

  2. Matt Goeringer says:

    I can get the data tags in the response now, but I noticed that it had turned the data-tag="to-do" attributes I posted into data-tag="blue-check-box" on the GET .../content.  Why doesn't it return the attribute as "to-do"?  

  3. Matt Goeringer says:

    When I get a page's content via http://www.onenote.com/.../pages[PAGEID]/content, it looks like the data-tags are removed.  I would like to be able to see the data-tags so I can read/modify the todo tags.  Is there a way to do that?

  4. Mary: We don't have an ETA on support for custom OneNote tags at this point in time. When we do, you'll find out about it here.

    Malcom: Support for page-level labels/categories is missing even from clients; iff those are added to OneNote they will definitely be supported through the API.

  5. malcolm goodwin says:

    Critically, you have the user defined #tag function missing that Evernote has...i heard that it is coming...but when?

  6. Mary Branscombe says:

    Custom tags next?

Skip to main content