AI Workshop: learn to build apps with AI →
Notion API: Notion API, update the icon emoji of a page

Join the AI Workshop and learn to build real-world apps with AI. A hands-on, practical program to level up your skills.


Here’s how to update the icon emoji value of a Notion page using the Notion API.

I’ll assume you have the Notion client initialized:

import { Client } from '@notionhq/client'

//...

const notion = new Client({ auth: process.env.NOTION_API_KEY })

Let’s say the page id is stored in the page_id variable.

Then you can do this to set the value of the page icon to a new emoji:

await notion.pages.update({
  page_id: page_id,
  icon: {
    type: 'emoji',
    emoji: '✅',
  },
})

Lessons in this unit:

0: Introduction
1: Notion API, how to retrieve the entries in a database
2: Notion API, select all pages with a specific emoji
3: Notion API, update a checkbox value in a database
4: ▶︎ Notion API, update the icon emoji of a page