Share via

☆☑ Announcing Tag Support

  • Article

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