Placeholders in Clippings

Predefined Placeholders

There are six predefined placeholders you can use in your clippings. These predefined placeholders will be automatically substituted with their expected values, as described below, when you paste the clipping.

Auto-incrementing Placeholders

Auto-incrementing placeholders are special placeholders that pastes a numeric value that is increased by 1 every time the clipping it belongs to is pasted. Auto-incrementing placeholder names are in the format #[variable_name]. Valid variable names can contain letters (lowercase or uppercase), digits (0-9) and underscores.

Specifying a starting initial value: In Clippings 6, go to the extension preferences page to set the starting value for all auto-incrementing placeholders. In Clippings 5.x, a prompt will appear whenever a clipping containing the auto-incrementing placeholder is pasted for the first time in the browsing session.

Resetting an auto-incrementing placeholder: This will cause the prompt for the initial placeholder value to reappear the next time you paste the clipping containing this placeholder. To reset an auto-incrementing placeholder:

Custom Placeholders

Available in Clippings 5.0 - 5.5.x, and Clippings 6.0.2 and newer.

You can define custom placeholders inside a clipping that you will be prompted to fill in when you paste the clipping.

Placeholders are essentially variables that appear in the clipping text in the format $[variable_name]. Valid variable names can contain letters (lowercase or uppercase), digits (0-9) and underscores. Example clipping with placeholders:

Hello, $[YourName], I'm glad you're coming to the meeting at $[meeting_time]. See you $[2nite]!

When you paste a clipping with placeholders, you will be prompted to fill in the value for each placeholder in the clipping. If you want the placeholders in the clipping pasted exactly as they are, with no prompting and substitution, the clipping name should be prefixed with [NOSUBST].

Default Values

Available in Clippings 5.0 - 5.5.x, and Clippings 6.0.2 and newer.

You can optionally specifiy a default value for your placeholder. A placeholder can have a single or multiple default values.


Back to the Help Index