Skip to content

Notion API, update the icon emoji of a page

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: '✅',
  },
})

I wrote 17 books to help you become a better developer, download them all at $0 cost by joining my newsletter

  • C Handbook
  • Command Line Handbook
  • CSS Handbook
  • Express Handbook
  • Git Cheat Sheet
  • Go Handbook
  • HTML Handbook
  • JS Handbook
  • Laravel Handbook
  • Next.js Handbook
  • Node.js Handbook
  • PHP Handbook
  • Python Handbook
  • React Handbook
  • SQL Handbook
  • Svelte Handbook
  • Swift Handbook

JOIN MY CODING BOOTCAMP, an amazing cohort course that will be a huge step up in your coding career - covering React, Next.js - next edition February 2025

Bootcamp 2025

Join the waiting list