To submit plugins or themes, or to manage an organization, you first need to sign in to the Obsidian Community directory with an [Obsidian account](https://obsidian.md/account/). ## Sign in 1. Go to [community.obsidian.md](https://community.obsidian.md). 2. In the upper-right corner, select **Sign in**. 3. If you already have an Obsidian account, sign in with it. 4. If you don't have an Obsidian account yet, follow the prompts to create one. You're now signed in to the community directory, and land on your **Community profile** page. ## Your community profile The sidebar lets you navigate between: - **Profile**: your community profile settings, covered below. - **Plugins**: your submitted plugins. - **Themes**: your submitted themes. - **Organizations**: organizations you belong to. For more information, refer to [[Organizations]]. - **Community site**: return to the public community directory. - **Log out** ### Connect your GitHub account Under **GitHub**, select **Connect** to link your GitHub account. This grants the directory read-only access to your public profile to verify that you own the repositories you submit, and is required before you can [[Submit your plugin|submit a plugin]] or [[Submit your theme|submit a theme]]. Selecting **Connect** first takes you to GitHub to authorize the connection. ### Manage notifications Enable **Action required notifications** to get an email if one of your plugins or themes has test failures or other actions required to remain listed in the directory. ### Edit your profile Under **Profile**, update your public details: - **Username**: lowercase letters, numbers, and hyphens. This is your public profile URL. - **Name**: your display name. - **Bio**: a description of yourself, up to 500 characters. - **Website**: a link to your website. - **Social accounts**: up to four links to social profiles. Select **Save** to apply your changes. ### Add funding links Under **Funding links**, select **Add funding link** to add links where people can support your work. These links are shown on all of your plugin and theme pages. ### Public profile Go to `community.obsidian.md/users/<handle>` to see how your profile appears to visitors. Your public profile shows: - Your icon, **Name**, and handle. - Your **Bio**, if set. - **Elsewhere** links to your **Website** and **Social accounts**, if set. - **Plugins** and **Themes** tabs, each showing a count, listing the entries you own. Each entry shows its icon, name, and description. ## Claim your plugins and themes After you authorize the [[#Connect your GitHub account|GitHub connection]], you're prompted to claim any plugins or themes hosted in a repository you own, or in a repository that belongs to a GitHub organization you're a public member of. 1. Under **Available to claim**, review the entries, grouped by GitHub user or organization. 2. Select or deselect individual entries using the checkboxes next to each one. 3. Use the **Claim as** dropdown to choose whether to claim the selected entries as **Myself**, or as an organization you belong to. 4. Select **Claim**. The button label includes the number of selected entries, for example **Claim 6 selected**. Claimed entries are added to your personal profile, or to the organization you claimed them as, and you can then [[Manage your plugin or theme|manage them]] from the **Plugins** or **Themes** page in the sidebar. ## Add a plugin or theme Go to the **Plugins** or **Themes** page in the sidebar and select **New plugin** or **New theme**. Fill out the submission form: - **GitHub repository URL**: the URL of your repository, for example `https://github.com/your-username/your-repo-name`. - **Owner**: who will own and maintain this entry. This doesn't have to match the repository's GitHub owner. Choose yourself, or an organization you belong to. Themes also require: - **Screenshot path**: the path to your screenshot, relative to the repository root, for example `screenshots/screenshot.png`. - **Supported modes**: select **Dark** and/or **Light** depending on which your theme supports. Review and agree to the [[Developer policies]], and confirm that you'll continue to support your plugin or theme, or remove or transfer it if you can no longer provide support. Then select **Submit**. For the full walkthrough, including preparing a release beforehand, refer to [[Submit your plugin]] or [[Submit your theme]]. ## Next steps Now that you're signed in and set up, you're ready to: - Prepare a full release, covered in the walkthroughs linked above. - [[Manage your plugin or theme]] once it's listed. - Create or join an [[Organizations|organization]] to share ownership of your entries with a team.