Styling Elements

Anytime you click on a component in the Layout tab, its editable properties will open on the right side of the editor window in the component editor. Here, you can see that clicking on the component in the layout tab opened its relevant properties in the component editor:

​

Component Specific Properties

By default, when you select a component you’ll see properties that are specific to it at the top of the component editor. For example, when you select a stack, you’ll see stack-specific options. The same is true of text and any other component. Notice how the options change at the top-right here when a stack versus a text component are selected:

​

Common component properties

Most components share similar properties related to things such as sizing, padding and more. Those are covered in more detail below.

Note that for any property that deals with editing a particular size, you can click on the disclosure arrow to choose a specific unit (such as rems):

Further, most values accept either an input amount or you can use a slider to set one. Some elements support hovering over them to reveal a slider, as well:

​

Tap Behaviors

You can have a component trigger a specific action when it’s tapped or clicked by adding a tap behavior. To add a tap behavior, click a component from either the Layout tab or the preview canvas, and in the component editor under under Tap Behavior click + Add Action:

Available tap actions are:

• Purchase: Begin a purchasing flow of the selected product.
• Set/Update Variable: Sets or updates an existing variable’s value. Options specific to the variable type will also be displayed. For example, a Number variable will have an option to choose an Operation such as Set, Increment or Decrement. Or, a Boolean variable’s Operation will offer to either Set or Toggle the boolean value.
• Select Product: Puts the chosen product in a selected state. Useful for scenarios such as focusing a product in a paywall drawer, for example, when something is tapped or clicked.
• Close: Closes the paywall.
• Restore: Begins a purchase restore operation. Useful for restoring purchases someone may have made prior.
• Open Url: Opens the given URL via one of three different ways:
  1. In-app browser: Attempts to open the link inside of the app using the platform’s web browser control. For example, on iOS, this opens an instance of SFSafariViewController.
  2. External: Attempts to open the link outside of the app using the platform’s web browser app. For example, on iOS, this opens Safari. Please note that the paywall stays presented when the link is opened.
  3. Deep Link: Similar to the external option, but it’ll close the paywall before opening the URL. This is useful for internal navigation or when you are attempting to link to something in a web page and you’d like the paywall to close when doing so.
• Custom Action: Performs a custom action that you specify. Using custom actions, you can tie application logic to anything tapped or clicked on your paywall. Check out the docs here.
• Custom Placement: Registers the placement you specify in the Name field. One common use-case is presenting another paywall from a currently opened one. Check out the example here.

​

Component styling properties

The properties below are editable regardless of which kind of component you are editing. The most important thing to keep in mind is that all of the properties below will work the same as they would on a web page. When you change these properties, behind the scenes — Superwall is applying the corresponding CSS code to the paywall.

​

Typography

Edit the text, size, color and more of a component’s text:

If you’ve added a custom font, you can also select it here.

​

Layer

Properties here edit the underlying layer of the component:

If you want a background fill, to toggle its overall opacity or other similar things — the layer is a great spot to do it.

​

Size

Use size properties to set an explicitly width or height on the component:

Using the dropdown arrow, you can set a range of minimum and maximum values:

​

Padding

Apply padding to the content within the component:

To have more granular control, expand each disclosure arrow to set only the top, bottom, left or right padding values:

​

Margin

Apply spacing to the content outside of the component, further separating it from adjacent components:

​

Corners

Applies a corner radius to the component:

Note that you may not see any change unless the component has some sort of background or layer fill. Further, if you’d like to adjust just one or more corners, click the dashed square icon to individually enter values:

​

Borders

Set a border around the the component:

You can set its width, style (i.e. dashed, solid, etc) and more.

​

Position

Specifies the position strategy used to place the component:

If you’d like to layer a component on top or below another component, the Z Index value is perfect here.

The most important value is what you use for position. Again, all of these options mirror their CSS counterpart. The available options are:

• Normal: The default option. The component will be positioned according to the normal flow of the paywall’s hierarchy. This is analogous to static in CSS.
• Relative: Positions the component relative to its normal position, allowing you to move it with top, right, bottom, and left offsets without affecting the layout of surrounding components.
• Absolute: Removes the component from the normal paywall hierarchy flow and positions it relative to its nearest positioned component (which won’t necessarily be a parent component).
• Fixed: Positions the component relative to the viewport, meaning it will stay in the same place even when the paywall is scrolled.
• Sticky: The component will behave as if it has a normal position until it teaches a certain point in the viewport. Then, it acts like it has a fixed position, sticking in place. This is great for sticky headers,footers or banners.

Mozilla has excellent developer docs over how the position CSS property works, along with interactive code samples. If you’re having some issues getting things placed how you’d like, this is a great resource to check out.

​

Effects

Applies CSS effects to the component:

If you’re new to CSS transitions and animations, check out this interactive reference.

​

Custom CSS

If you need to add some one-off custom CSS code, you can add them here. Just click + Add Property:

From there, type in the CSS property you need and select it from our dropdown menu:

Here, you can see a manually set background value for the selected component:

​

CSS Output

As you make any changes to these properties, you can see the actual CSS that Superwall is applying by scrolling down in the component editor to the CSS Output section:

This can be useful for debugging or further refining your designs.