# Tab ## class **Tab** #### Constructor ```python # Only required parameters tab = Tab(name="Custom Tab") # All parameters tab = Tab( name="Custom Tab", icon="users", gap: 8, title="My Custom Tab" ) ```

Parameter	Description
name	Allowed: `string` Must be unique across the whole UI, cannot be longer than 36 characters
icon	Allowed: `string` Icon tab Available icons: #icons
gap	See Gap Default: `6` Spacing between CardContainer elements. In most cases you can omit this.
title	Allowed: `string \| None` Default: `None` Displayed at the top of your custom tab, above the cards.

#### Methods

Method Description

create_container(type, **kwargs) Adds a CardContainer to the Tab.

render() Initializes the Tab. Should be called last, after all UI elements, cards, and containers are defined.

toast(title, description, type)

Method	Description
create_container(type, **kwargs)	Adds a CardContainer to the Tab.
render()	Initializes the Tab. Should be called last, after all UI elements, cards, and containers are defined.
toast(title, description, type)	Displays a toast notification inside the app. Parameters: Title: `string` \| required Description: `string` \| required Type: `"INFO"`, `"ERROR"`, `"SUCCESS"` \| required Example: `tab.toast(type="INFO", title="Hello, World!", description="Welcome from py!")` Note: The toast will only display if the custom tab is open.

Displays a toast notification inside the app.

Parameters:

Title: string | required
Description: string | required
Type: "INFO", "ERROR", "SUCCESS" | required

Example:

tab.toast(type="INFO", title="Hello, World!", description="Welcome from py!")

Note: The toast will only display if the custom tab is open.

#### Icons

Image	String
	report
	chart
	two_way
	inbox
	star
	search
	variants
	message
	users
	history
	clean
	magic
	eraser
	convert
	cloud
	calc
	calendar
	key
	gift
	trophy
	book
	sun
	cart
	pill
	bookmark
	mail
	bear
	heart
	music
	umbrella
	tube
	palette
	lock
	fire
	preferences
	power
	share
	bell
	trash
	nitro

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.nighty.one/ui-scripting/api-reference/tab.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.