Integrating Symbols
Symbols are a type of section model you will want to integrate for editing on your site or app. They allow you to elegantly reuse content across many Builder pages and sections. Learn more about symbols.
Prerequisites
To follow along with this tutorial, you should have the following:
- a Builder account
- an app in the framework of your choice with the appropriate Builder SDK installed
- you should have already integrated page building or section building
👉 Tip: If you need to create an app, follow the steps for your framework in the Create an app section of Integrating Page Building.
Add symbol editing to your app
First, you'll want to create a special page on your site specifically for symbol editing. This is what the Builder preview will open up when creating and editing symbols. It's important this is on a URL directly on your site so all previewing and editing is accurate.
In this guide, we will assume we are calling this page /edit-symbol
Update your symbol preview URL
Head over to builder.io/models and choose your "symbol" model.
Then enter your site domain at this new /edit-symbol path we just created, e.g. https://my-site.com/edit-symbol.
You can use localhost when testing locally, then change to a hosted URL like your QA or production URL once your code updates have been deployed.
