This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.


Name Type Description
type str Type of the entity. Can be 'mention' (@username), 'hashtag' (#hashtag), 'cashtag' ($USD), 'bot_command' (/start@jobs_bot), 'url' (, 'email' (, 'phone_number' (+1-212-555-0123), 'bold' (bold text), 'italic' (italic text), 'underline' (underlined text), 'strikethrough' (strikethrough text), 'code' (monowidth string), 'pre' (monowidth block), 'text_link' (for clickable text URLs), 'text_mention' (for users without usernames)
offset int Offset in UTF-16 code units to the start of the entity
length int Length of the entity in UTF-16 code units
url Optional[str] Optional. For 'text_link' only, url that will be opened after user taps on the text
user Optional[User] Optional. For 'text_mention' only, the mentioned user
language Optional[str] Optional. For 'pre' only, the programming language of the entity text


  • from aiogram.types import MessageEntity
  • from aiogram.api.types import MessageEntity
  • from aiogram.api.types.message_entity import MessageEntity