Step-by-step tutorials
for FeaturePin

The SDK is a single JavaScript snippet you add once to your product. No framework-specific packages needed.

1. Log in to app.featurepin.com and go to Settings.
2. Copy your SDK snippet. It looks like: <script src="https://sdk.featurepin.com/fp.js" data-token="your-workspace-id" async defer></script>
3. Paste it before the closing </body> tag of your application.
4. Call featurepin.identify(userId, properties) after your user authenticates so FeaturePin can target campaigns by user properties.
5. Reload your app. You should see a green checkmark in the FeaturePin dashboard confirming the SDK is active.

Tip: The SDK is under 10 KB gzipped and loads asynchronously. It never blocks your app's render.

Announcements are campaigns you launch manually to all users or a specific segment.

1. From the dashboard, click New campaign.
2. Choose Announcement as the type.
3. Select the message format: Modal, Banner, or Tooltip.
4. Fill in the title, body text, and an optional call-to-action button with a URL.
5. Set targeting: All users or a segment based on user properties.
6. Click Save as draft to review, or Launch to publish immediately.

Tip: Start with a modal for important launches. Banners work better for lightweight updates that should not interrupt the workflow.

Nudges are automated campaigns that trigger based on user behavior rules. They run without any manual action from you.

1. From the dashboard, click New campaign and choose Nudge.
2. Define the trigger rule: for example, "user has not visited /reports in the last 14 days".
3. Choose the message format and write your nudge copy.
4. Set a frequency limit to avoid showing the same nudge too often (recommended: once per week).
5. Click Activate. The nudge evaluates every 15 minutes against your active users.

Tip: Keep nudge copy short and action-oriented. "You have not tried Reports yet — here is how it saves time" outperforms generic "Check out our new feature".

Announcements are manually triggered by you. You decide when to show them, typically for product launches, release notes, or time-sensitive messages. They fire once per user unless you relaunch them.

Nudges are rule-based and automatic. You define a condition (a URL the user has not visited, a feature they have not used, N days of inactivity) and FeaturePin checks it automatically every 15 minutes.

When to use which: Announcements for "we just shipped X". Nudges for "users who have not discovered X yet".

Targeting lets you show a campaign only to users who match specific properties.

1. In the campaign editor, go to the Targeting section.
2. Switch from All users to Segment.
3. Add one or more rules: property + operator + value. Example: plan = free or company_size > 50.
4. Multiple rules use AND logic by default (all conditions must match).
5. Save the campaign. Only users whose properties match will see it.

Tip: User properties come from your featurepin.identify() call. Pass any JSON-serializable key-value pair and it becomes available for targeting.

You can pause an active campaign at any time. Paused campaigns stop showing to new users immediately.

1. Go to the Campaigns list and find your campaign.
2. Click the ... menu and select Pause.
3. To resume, click ... and select Activate.
4. To archive a campaign you no longer need, select Archive. Archived campaigns are hidden from the active list but their analytics are preserved.

Tip: Pause time-sensitive announcements once they are no longer relevant. It keeps your campaign list clean without losing historical data.

Each message format has a different visual weight and interruption level.

Modal — a centered overlay that blocks the background. Use for important announcements that require attention: major releases, breaking changes, mandatory actions.

Banner — a full-width bar at the top or bottom of the page. Lower interruption than a modal. Good for informational updates, ongoing promotions, or trial expiry notices.

Tooltip — a small popover anchored to a specific URL. Ideal for nudges pointing to a specific area of the product.

Tip: When in doubt, use a banner. Modals are the highest-friction format — save them for announcements that truly need a full stop.

Each campaign has an analytics panel showing how users responded to it.

1. Open any campaign and click the Analytics tab.
2. Impressions — the number of times the campaign was shown to a user.
3. Clicks — the number of times users clicked the CTA button.
4. Dismissals — the number of times users closed or dismissed the campaign.
5. The click rate is clicks divided by impressions. A healthy announcement click rate is 10 to 30 percent.

Tip: A high dismissal rate with low clicks usually means the message is not relevant to the segment. Narrow the targeting or rewrite the copy.

Impression: the campaign widget was rendered and visible to the user. Recorded once per user per campaign session.

Click: the user clicked the primary CTA button. If there is no CTA, no clicks are recorded.

Dismissal: the user closed or dismissed the campaign without clicking the CTA. For modals, this includes clicking outside the modal or pressing Escape.

Events are batched and sent every few seconds to reduce network overhead. You may see a small delay (under 30 seconds) before they appear in the dashboard.

MAU (Monthly Active Users) is the billing unit for FeaturePin. It counts unique end users seen by your workspace in the last 30 days.

1. A user is counted when your SDK calls featurepin.identify(userId) or when an SDK event is received for that user.
2. The 30-day window rolls daily: users last seen more than 30 days ago drop out of the count automatically.
3. Anonymous sessions (without an identify call) are not counted toward MAU.

Tip: You can check your current MAU at any time in Settings → Usage. You will also receive an email when you reach 80% of your plan limit.

You can upgrade at any time from the dashboard. The new limits are active immediately.

1. Go to Settings → Billing.
2. Click Upgrade next to the plan you want.
3. Enter your payment details. Billing is monthly.
4. Your workspace plan updates instantly. All existing campaigns and data are preserved.

Tip: If you are evaluating FeaturePin for a larger team, reach out at hello@featurepin.com before upgrading. We can help you pick the right plan.

FeaturePin does not cut off your campaigns abruptly. Here is what happens as you approach the limit:

1. At 80% of your limit, you receive an email notification.
2. At 100% of your limit, campaigns continue to run but new end users above the limit will not see them until you upgrade.
3. You can upgrade at any time from Settings → Billing to restore full coverage immediately.

Tip: On the free plan, FeaturePin branding is shown inside campaigns once you exceed 1,000 MAU. Upgrading to any paid plan removes it.

The free plan shows a small "Powered by FeaturePin" label inside campaigns shown to users beyond 1,000 MAU. Upgrading to any paid plan removes it.

1. Go to Settings → Billing and upgrade to the Grow plan or above.
2. Branding is removed from all campaigns immediately after upgrade. No code changes needed.

Tip: The branding label only appears for users above the free MAU cap. If your workspace has fewer than 1,000 active users, you will never see it on the free plan.

Your SDK token is your workspace ID. It is a public identifier that tells the SDK which workspace to load campaigns for. It is intentionally not a secret.

1. Go to Settings → SDK in the dashboard.
2. Your SDK snippet is shown pre-filled with your token in the data-token attribute.
3. You can also copy the raw token value if you need it for a custom integration.

Tip: The token is safe to include in your frontend code and is visible to anyone who inspects your page source. It only identifies your workspace, it does not grant access to your account.

Workspace settings let you update your workspace name and manage your SDK configuration.

1. Go to Settings → Workspace.
2. Update the workspace name and click Save.
3. The workspace name appears in the dashboard and in emails sent to your team.

To delete your workspace and all associated data, email hello@featurepin.com. Deletions are processed within 48 hours.