☆☑ 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

• Anonymous
  October 17, 2014
  Custom tags next?

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

• Anonymous
  October 19, 2014
  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.

• Anonymous
  March 02, 2015
  When I get a page's content via 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?

• Anonymous
  March 02, 2015
  The comment has been removed

• Anonymous
  July 14, 2017
  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