Skip to main content
Create “Open in NearPlay” buttons that let users instantly open your contracts in NEAR Playground. Use cases:
  • GitHub READMEs - Let users try your contract without cloning the repo
  • Documentation - Add interactive examples to your tutorials
  • Blog posts - Embed runnable code samples in your articles
  • Learning resources - Provide instant access to example contracts
  • Project showcases - Let visitors explore your smart contracts live

My Embeds

The Embeds page displays all your created embed buttons in a table:
ColumnDescription
NameEmbed name
TypeSource type badge (github or project)
ClicksNumber of times the button was clicked
ViewsNumber of times the button was viewed
CreatedWhen the embed was created
ActionsCopy code, Preview, or Delete
My Embeds

Creating an Embed

Click the Create Embed button to open the creation modal. You can create embeds from three sources:

From Template

Create an embed for a template in the marketplace:
  1. Go to the Embeds page
  2. Click Create Embed
  3. Select the Template tab
  4. Choose a template from the dropdown
  5. Customize the button text and style
  6. Preview the button appearance
  7. Copy the embed code
  8. Click Create Embed
Embed from template

From Project

Create an embed for one of your projects:
  1. Go to the Embeds page
  2. Click Create Embed
  3. Select the Project tab
  4. Choose your project from the dropdown
  5. Customize and copy the embed code
  6. Click Create Embed
Embed from project

From GitHub

Create an embed directly from a GitHub repository:
  1. Go to the Embeds page
  2. Click Create Embed
  3. Select the GitHub tab
  4. Enter the repository URL (e.g., https://github.com/owner/repo)
  5. Customize and copy the embed code
  6. Click Create Embed
Embed from GitHub

Customization Options

OptionDescription
Button TextCustom text displayed on the button (default: “Open in NearPlay”)
StyleButton appearance style (Outline, Filled, etc.)

Embed Code Formats

The embed code is available in three formats:
FormatBest For
HTML (Image)Shield.io badge - works everywhere
HTML (Button)Styled HTML button
MarkdownGitHub READMEs and documentation

Tracking

Each embed tracks clicks and views automatically. View statistics in the My Embeds table to see how your embeds are performing.