Webflow maintenance

How do I add a property to a Webflow component?

Add a Webflow component property so one instance can change its text, image, link, or visibility without unlinking.

THE SHORT ANSWER

Edit the main component and create a property for the text, image, link, or visibility that should differ on each instance. Suggested props can create several at once. You can also create one from the purple dot beside that setting. On the instance, change the property value only. The shared structure stays on the main component. A component that is identical everywhere does not need a property.

Use a property when instances should differ

A component keeps one structure in sync everywhere it is used. That is what you want for a navbar that should match on every page. It is the wrong default for a hero that should say something different on the pricing page than on the homepage. A component property is the value you are allowed to change on one instance: the text, the image, the link, the video, the number, or whether an element is visible.

The component guide is how you turn a block into a component. This page starts after that component exists. A slot is a place where you drop other components into an instance. The slot guide is that control. A property holds a value for an element already inside the component.

If every instance should stay identical, skip properties. Webflow's properties article names navbars, footers, and some forms as that case.

Example: a card component is used on three service pages. The layout stays shared. The heading on each card should name that service. Create a text property for the heading, leave the layout on the main component, and type a different heading on each instance.

Create the properties on the main component

Properties are created on the main component, then overridden on an instance. Double-click a component instance to edit the main component.

Webflow can suggest properties when it finds supported elements that are not connected yet. Open the Properties panel with the Properties icon in the left toolbar, or press K. If suggestions are listed, click Review. You can rename one with the pencil icon, and you can deselect any you do not want. Click Create. Webflow creates the ones you kept and connects them.

You can also make one property for a specific setting:

  • Double-click the instance so you are editing the main component.
  • Select the element, such as the heading.
  • Open the Element settings panel.
  • Click the purple dot next to the value you want to expose, such as the text or the link.
  • Click Create, and set the property name and the default value.
  • Click Create again to confirm.

The default value is what new instances show until someone overrides them. Name the property for the person who will edit the instance, such as Card heading, not Heading 2.

You can also create a property from the plus icon in the Properties panel, then connect it from the purple dot. Until an element is connected, the property does not change the canvas.

Change one instance

Leave the main component when the property exists. Webflow documents the exit as the back arrow at the upper left of the Designer, or the Esc key. You are then on the instance, not on the shared main component.

Select the instance. In the right panel, change the property value: replace the heading, swap the image, or edit the link. You can also click the instance and double-click the element on the canvas. Elements connected to a property show a dotted green outline there. Editing that outlined text changes the instance. Editing while you are still inside the main component changes every instance.

Check a second page that uses the same component. The heading should differ only where you overrode it. If every card changed, the edit landed on the main component.

To restore the defaults, select the instance, open the more options dots in the upper right of its right panel, and choose Reset all properties. One property resets from its name in the right panel, with Reset to default property value.

Visibility is a switch

A switch property shows or hides an element on that instance. Webflow's examples are a navbar link you do not need on one page, an icon inside a button, or a group of elements in a section. Create the switch on the main component, connect it to the element's visibility, then toggle it on the instance.

Hidden elements are removed from the page structure. Webflow says they are left out of the document order, so assistive technology does not read them. In the Navigator, a struck-through eye marks the hidden element inside the component. That is how you find a block you turned off.

A switch is manual. If the element should appear from CMS data, a component property, or the current locale, Webflow says to use conditionals. The conditional visibility guide is that system.

Styles are not a content property. Webflow says to use the class custom attribute when one instance needs its own style. A text property will not store a different font size for one card.

Remove a property without unlinking the component

To delete a property, open the main component, find it in the Props panel, and click the trash icon. If it is still connected, deleting it disconnects it. Webflow says that content is replaced with the default value you set. Instances do not keep their old overrides after the delete.

You can disconnect without deleting. In the Properties panel on the main component, click the property, click the connected element, open the purple menu, and choose Disconnect property. Repeat that when one property feeds several elements.

Collection lists cannot be nested inside a component. A property can still connect to Collection fields on a Collection page, including plain text and image, after the property exists. A component instance that sits inside rich text cannot connect its properties to CMS fields.

The edit guide covers which edits your own team should keep. A property is what lets them change one heading without unlinking the component.

A property on a component you already use is ordinary component work. The membership is one plan for every existing Webflow site: $999 per month, including 10 hours of Webflow work. Additional work is $75 per hour and starts only after you approve a written estimate.

Questions & answers

I changed the heading on the instance and every page changed. What did I edit?

That edit was on the main component, or the text was not connected to a property. Exit the main component and change the property value on the instance. A property is what lets one instance differ.

Do I need a property on a footer that is the same on every page?

No. Webflow says a component with the same content in every instance, such as many navbars, footers, and forms, does not need properties. Create one when the content or the visibility should vary.

Can I set a different font size on one instance with a property?

Not with a content property. Webflow says style changes on an instance use the class custom attribute. A text property changes the words. It does not store a font size for that instance alone.

I deleted the property. Can the old instance text come back from another page?

No. Deleting a property disconnects it, and the connected content is replaced with the default value you set. Add a new property and connect it if you still need per-instance text.

Sources & further reading

Need a hand with your Webflow site?

View membership